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PREFACE 



MANUAL OBJECTIVES 

This manual describes the operation of the Crash Dump Analyzer (CD A ) . 
It does not attempt to describe the operation of the RSX-11M-PLUS 
Executive or the significance of the individual data structures. The 
RSX-11M/M-PLUS Executive Reference Manual and the RSX-11M and 
RSX-11M-PLUS Guide to Writing an I/O Driver describe these data 
structures . 



INTENDED AUDIENCE 

This manual is intended for system managers who are responsible for 
interpreting system failures and for system operators who run CDA to 
generate dumps. Understanding CDA output requires a working knowledge 
of assembly language programming and the Executive data structures. 



STRUCTURE OF THIS MANUAL 

Chapter 1 explains the function of the Crash Dump Analyzer. It 
describes the system resources necessary and the procedure for 
obtaining a crash dump. The chapter continues with an overview of 
loadable crash dump drivers, and explains how to run CDA. The chapter 
also describes indirect command files as they pertain to CDA. 

Chapter 2 describes the two ways that you can use CDA: by issuing the 
CDA command line or the DCL ANALYZE/CRASH_DUMP command. The chapter 
begins by describing the CDA command line format, including command 
line specifications and switches. Two summary tables provide quick 
reference on switch operation. Finally, the chapter concludes with a 
description of the DCL ANALYZE/CRASH_DUMP command. 

Chapter 3 consists of examples and descriptions of CDA output 
listings . 

Chapter 4 contains helpful hints for interpreting CDA output listings. 

Appendix A contains a short description of each CDA error message. 

Appendix B lists system macros that supply symbolic offsets for system 
data structures for RSX-llM. 

Appendix C lists system macros that supply symbolic offsets for system 
data structures for RSX-11M-PLUS. 

Appendix D lists error code definitions for Micro/RSX operating 
systems. 
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ASSOCIATED MANUALS 

Refer to the RSX-11M/RSX-11S Information Directory and Index for a 
brief description of each manual in the RSX-11M documentation set. 

Refer to the RSX-llM-PLUS Information Directory and Index for a brief 
description of each manual in the RSX-llM-PLUS documentation set. 



CONVENTIONS USED IN THIS MANUAL 



© This symbol indicates that you press the RETURN key. 

[] Square brackets show elements in a command line format 

that are optional. For example, [/switch] indicates 
that you can include a switch if you want to, but you 
do not have to. 



[,...] Square brackets around a comma and an ellipsis mark 

indicate that you can use a series of optional elements 
separated by commas. For example, (argument [,...] ) 
means that you can specify a series of optional 
arguments by enclosing the arguments in parentheses and 
separating them with commas. 

red ink Red ink in the examples of this manual denotes user 

input . 



pink shading Pink shading in this manual indicates features that are 

specific to RSX-llM operating systems only. 

gray shading Gray shading indicates features that are specific to 
RSX-llM-PLUS operating systems only. 
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TECHNICAL CHANGES 

• The system Assign Table, which is one of the report listings 
that CDA generates, has been changed. The table now lists 
logical assignments in two categories: system logical 
assignments, and user logical assignments. The entry in the 
table for each assignment includes its size in blocks, its 
type, and its status. 

• Some of the system data structures that are shown in Appendix 
B and Appendix C have changed as a result of new system 
features such as support for logical names and networking. 
Refer to the specific data structures in Appendix B (RSX-11M) 
or Appendix C (RSX-11M-PLUS ) to see the changes. 



NEW DEVICE SUPPORT 

You can specify any of the following new devices as the crash dump 
device for your system: 

For RSX-11M/M-PLUS Systems 

Device Type Mnemonic 

RA60/RX50 disk packs DU: 
RC25 removable disk packs DU: 
TK25/TU80 magnetic tapes MS: 
TK50 magnetic tapes MU: 

For Micro/RSX or Pregenerated RSX-11M-PLUS Systems 

Device Type Mnemonic 

RD52 disks DU: 
TK25 magnetic tapes MS: 
TK50 magnetic tapes MU: 



ADDITIONS TO THE CRASH DUMP ANALYZER REFERENCE MANUAL 

The following documentation has been added to this manual: 

• Chapter 1 now includes a description of loadable crash dump 
support for Micro/RSX and pregenerated RSX-11M-PLUS systems. 
You load a crash dump driver by specifying a crash dump 
device. If the system crashes when the driver is loaded, the 
driver dumps the contents of memory at the time of the crash 
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onto the specified crash dump device. When you do not want a 
crash driver resident in memory, you can unload it to the 
system disk. Thus, loadable crash drivers allow you to choose 
when you want crash dump support. 

• Chapter 2 now includes a description of the DCL 
ANALYZE/CRASH_DUMP command. If your terminal supports the 
DIGITAL Command Language (DCL) command line interpreter, you 
can use the ANALYZE/CRASH DUMP command to run CDA. Command 
qualifiers let you choose which report listings you want CDA 
to generate. You can also use qualifiers to specify the 
format of the CDA report listings. 

• A new appendix, Appendix D, lists error code definitions for 
Micro/RSX operating systems, including facility-independent 
definitions and Bugcheck standard format definitions. 
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CHAPTER 1 
INTRODUCTION 



This chapter introduces the Crash Dump Analyzer (CDA) . It describes 
the function of CDA, details the system features that CDA requires, 
and explains how to obtain a crash dump. The procedures for 
generating a crash dump vary from system to system. This chapter 
explains how to obtain a crash dump on different types of systems. 
Then this chapter describes how to run CDA, and how to use CDA with 
indirect command files. Finally, the last section of the chapter 
lists the six basic analysis listings that the Crash Dump Analyzer 
generates . 



1.1 CRASH DUMP ANALYZER FUNCTION 

CDA is a specialized utility that helps you establish the cause of 
system crashes. It is installed in a system as a nonpr i vileged task 
that any user can run. CDA reads the contents of a memory dump 
created by the crash dump routine of the Executive. CDA then uses the 
data in the Executive symbol table file (RSX11M.STB) to format the 
binary input of the memory dump into readable analysis listings. 
Finally,r CDA prints the analysis listings on a line printer. 
Examining the CDA listings can help you to determine the cause of a 
system crash. 

CDA is a nonpr ivi leged task that any user can run. 



1.2 SYSTEM REQUIREMENTS 

Micro/RSX operating systems with the Advanced Programmer's Kit and 
pregenerated RSX-11M-PLUS operating systems support loadable crash 
dump drivers. Refer to Section 1.4 for a description of loadable 
crash dump support. 

On RSX-11M operating systems, and on non-pregenerated RSX-11M-PLUS 
operating systems, you can select support for crash dump analysis 
during system generation. Refer to the RSX-llM System Generation and 
Installation Guide or the RSX-11M-PLUS System Generation and 
Installation Guide for instructions on how to include CDA in your 
system. If you select support for crash dump analysis during system 
generation, you specify a crash notification device and a crash dump 
device. The system then builds a crash dump routine into the 
Executive. Thereafter, when the system crashes, the crash dump 
routine displays a message on the crash notification device and writes 
the contents of memory onto the specified crash dump device. The 
contents of memory are the input to CDA. If you decide to change the 
crash dump or crash notification devices, you must perform another 
system generation in order to specify the new devices. 
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Since CDA overwrites the contents of the crash dump device, you should 
not specify the system device as the crash dump device. Also, the 
following fixed disks cannot serve as CDA crash dump devices: 

RA80 
RA81 
RD51 
RC25 



However, you may use any of the following mass storage devices as 
crash dump device for your system. 

For RSX-11M/M-PLUS Operating Systems 

Device Mnemonic 



the 



RP04/RP05/RP06 disk packs DB 

DECtape II (TU58) DD 

RK05/J/F disk cartridge DK 

RL01/RL02 disks DL 

RK06/RK07 disk cartridges DM 

RM02/RM03/RM05 disk packs DR 

DECtape (TU56) DT 

RC25 removable disk pack DU 

RA60/RX50 disk packs DU 

RX01 diskette (RSX-11M only) DX 

RX02 diskette DY 

TU45/TU16/TE16/TU77 magnetic tapes MM 

TS11/TU80/TSV05/TK25 magnetic tapes MS 

TS03/TU10/TE10 magnetic tapes MT 

TK50 magnetic tapes MU 

For Micro/RSX and Pregenerated RSX-11M-PLUS Operating Systems 



Device 

RL01/RL02 disks 
RD51/RD52/RX50 disks 
TSV05/TK25 magnetic tape 
TK50 magnetic tapes 



Mnemonic 

DL: 
DU: 
MS: 
MU: 



1.3 OBTAINING A CRASH DOMP 

To obtain a crash dump, control of the processor must be transferred 
to the Executive crash dump routine following a system crash. The 
transfer of processor control depends on how the crash occurred and 
whether you built the Executive Debugging Tool (XDT) into your system 
during system generation. 

System crashes can result from any of the following causes: 

1. The processor encounters a program condition that causes it 
to trap to location 40 or to XDT. 

2. An infinite loop condition occurs. 

3. The processor encounters an unintentional HALT instruction in 
kernel mode (000000) . 
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When a program condition causes a processor trap and XDT is included 

in your system, control transfers automatically to XDT. You can then 

type X at the console terminal, and XDT transfers control to the crash 
dump routine. For example: 

XDT>X (RET) 

Refer to the RSX-11M/M-PLUS and Micro/RSX Debugging Reference Manual 
for a description of XDT. 

If your system does not include XDT, a processor trap causes control 
to be transferred directly to the crash dump routine of the Executive. 

When a system crash is the result of a HALT instruction or an infinite 
loop condition, you must restart the processor manually at location 
40. 

Regardless of how control is transferred, once the processor enters 
the crash dump routine, the routine prints the following informational 
message on the crash notification device: 

CRASH-CONT WITH SCRATCH MEDIA ON ddnn 

After displaying the message, the crash dump routine halts the 
processor so you can put the crash dump device on line. When the 
device is on line, restart the processor by depressing the Continue 
switch on the processor console. The crash dump routine then dumps 
memory on the crash dump device and halts the processor when the dump 
finishes. The volume in the crash dump device now contains a binary 
representation of the contents of memory at the time of the crash. 
These contents are the input to CDA. You can then reboot the system 
and run CDA to analyze the dump. 

If you attempt to crash to an illegal device, the crash dump routine 
displays the following message on the crash notification device: 

CRASH — ILLEGAL CRASH DEVICE 

After displaying the message, the crash dump routine halts. The 
illegal crash device error occurs if you specify a fixed media device 
as the crash dump device. If you have a removable media device on the 
same controller, you can switch the physical unit number plugs on the 
devices to assign the removable media device to the crash device. 
Then press the Continue key on the operator's console and the crash 
dump routine will attempt the dump again. 



1.4 LOADABLE CRASH DUMP DRIVERS 

The pregenerated RSX-11M-PLUS operating system and the Privileged 
Development option of the Micro/RSX Advanced Programmer's Kit include 
loadable crash dump drivers. Loadable drivers reside on an external 
storage device when they are not in use. Using loadable drivers for 
crash dump support reduces the size of the Executive and frees memory 
space for other purposes. 



1.4.1 Crash Devices 

Loadable crash dump support is provided by four loadable crash dump 
drivers, each of which dumps the contents of memory to a specific type 
of device. The following list shows the crash dump drivers and their 
corresponding device types. 
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Crash Dump Driver 



Crash Dump Device 



DLCRSH.TSK 



RL02 cartridge disk 



DUCRSH.TSK 



RX50 diskette 



MSCRSH.TSK 



TSV05/TK25 magnetic tape 



MUCRSH.TSK 



TK50 magnetic tape (Micro/RSX) 
TK50 magnetic tape (RSX-11M-PLUS ) 



If the crash dump driver is loaded and the system crashes, the 
contents of memory are dumped to the designated crash device. You can 
then use the Crash Dump Analyzer to investigate the cause of the 
crash. If there is not a crash driver resident in the system when the 
system crashes, the Bugcheck facility displays the following message: 

SYSTEM FAULT DETECTED AT PC=xxxxxx FAC I L ITY=xx xx xx ERROR CODE=xxxxxx 
CRASH — CRASH DRIVER NOT LOADED 



1.4.2 Loading a Crash Dump Driver 

A loadable crash driver resides on the system disk until you specify a 
crash device. To specify a crash device, use the following command: 

SET SYSTEM /CRASH_DEVICE : ddn : (ret) 

This command loads a specific crash driver into a main memory 

partition and updates the crash data base. Also, you may use this 

command to change the crash dump device or to change the unit number 
of the crash device while the system is running. 

When the crash driver is successfully loaded, you receive the 
following message: 

SET — Crash device ddn: has been successfully loaded 

If the device that you specified as the crash device is not in the 
current system, the following error message is displayed: 

SET -- Device not in system 

If a crash driver is already loaded and you specify a different device 
with the SET S YSTEM/CRASH_DEVICE command, the system unloads the 
resident crash driver, loads the new driver for the device that you 
specified, and updates the crash data base. If a crash driver is 
loaded and you specify the same device but a different unit number, 
the resident driver remains loaded and the system changes the device 
unit number in the crash data base. 

If you specify the system disk as a crash device, you receive the 
following warning message: 

SET — WARNING, System disk chosen as crash device 
SET — Crash device ddn: has been successfully loaded 



nnnnnn 
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Note that if your system disk is a removable disk, it is a valid crash 
dump device. The system warns you that you have specified the system 
disk, but it loads the crash dump driver for the disk despite the 
warning message. You should avoid using the system disk as the crash 
dump device, because the memory dump will overwrite the contents of 
the disk, unless you remove the system disk and replace it with a 
scratch disk when the system crashes. 

It is not possible to crash to a fixed media device such as the RD51 
fixed disk. If you indicate the RD51 or any other fixed disk as a 
crash device, you receive the following message: 

CRASH — ILLEGAL CRASH DEVICE 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

At this point, you cannot obtain a crash dump of memory. 



NOTE 

You cannot select a crash device and unit number once 
the crash has occurred. 



However, you may choose a crash device unit that is not in the current 
system. To do this, specify the address of the control and status 
register (CSR) of the device that you want as the crash device. Use 
the /REGISTER switch to specify the address of the CSR of the desired 
device : 

SET SYSTEM /CRASH_DEVICE : ddn : REGISTER : csraddr © 

To display the current crash dump device unit, use the following 
command : 

$ SHOW SYSTEM /CRASH_DEVICE (RET) 

In response to this command, the system displays the current device 
unit, as follows: 

CRASHDEV=ddn: 



1.4.3 Unloading a Crash Dump Driver 

You use the following command to unload a crash dump driver when crash 
dump support is unnecessary: 

$ SET SYSTEM /NOCRASH_DEVICE (ret) 

In response to this command, the system displays the following 
message : 

SET — Crash device ddn: is being unloaded 
SET -- WARNING, Crash dump support is inactive 

The system then unloads the crash dump driver and updates the crash 
data base. When there is no crash dump driver resident in memory, the 
Bugcheck facility services system crashes (refer to Appendix D for a 
list of error code definitions used by Bugcheck) . Unloading the crash 
dump driver frees the memory space in the crash driver partition until 
you decide to reactivate crash dump support. You can reactivate crash 
dump support at any time simply by specifying a new crash device unit. 
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1.4.4 When the System Crashes 

When a Micro/RSX or pregenerated RSX-11M-PLUS operating system 
crashes, the reaction of the system depends on the type of crash 
support that is loaded when the crash occurs. There are three types 
of crash support: 

1. The Bugcheck facility, which is a standard part of the 
operating system, and is therefore resident in memory 

2. Loadable crash dump drivers 

3. XDT, which is also loadable 

Thus, when a system crashes, any of the following conditions may 
exist : 

• A crash dump driver is loaded but XDT is not 

• Both a crash dump driver and XDT are loaded 

• XDT is loaded but a crash dump driver is not 



1.4.4.1 A System Crash with a Driver Loaded and XDT Unloaded - If a 

system crashes when a crash driver is loaded but XDT is not loaded, 
the crash dump routine notifies you of the crash with the following 
message : 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

After displaying this message, the crash routine halts the hardware 
processor so that you can make sure there is a scratch media in the 
crash device. When you have the crash device ready, press the P key 
followed by a carriage return to proceed. 

In response to your command to proceed, the crash dump routine dumps 
memory to the designated crash dump device. When the dump is 
completed, the processor is again halted. During the memory dump, the 
processor Run light is on; when the dump is completed, the processor 
Run light goes off. 

At this point, the medium in the crash dump device contains a binary 
representation of the contents of memory at the time the system crash 
occurred. This memory dump is the input to CDA. Now you can use the 
ANAL YZE/CRASH_DUMP command, which is described in Section 2.2 of this 
manual, to control how CDA processes the crash dump. Then you can 
analyze the output listings that CDA generates to determine why your 
system crashed. 



1.4.4.2 A System Crash with a Driver Loaded and XDT Loaded - If a 

system crashes when a crash driver and XDT are loaded, control is 
transferred to XDT. After you use XDT to debug the system, if you 
want to obtain a crash dump, press the X key followed by a carriage 
return. The following message is then displayed: 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

Now you can follow the procedure in Section 1.4.4.1 to obtain the 
crash dump. 
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1.4.4.3 A System Crash with only XDT Loaded - If a system crashes 
when XDT is loaded but a crash driver is not loaded, control is 
transferred to XDT. However, when you enter the X command, the 
following is displayed: 

SYSTEM FAULT DETECTED AT PC=xxxxxx FACILITY=xxxxxx ERROR CODE=xxxxxx 
CRASH — CRASH DRIVER NOT LOADED 



1.4.4.4 Inducing a System Crash - In some situations, you may want to 
purposely induce a system crash. Then, if you have a crash driver 
loaded, you can dump the contents of memory and examine them. For 
example, suppose that you want to stop the processor from executing in 
an infinite loop. You can induce a system crash by performing the 
following procedure: 

1. Push the Halt button on the processor. On processors with 
console ODT, the following is displayed: 

nnnnnn 
@ 

2. Release the Halt button. 

3. At the terminal, type 40G. The following is displayed: 
CRASH — CONT WITH SCRATCH MEDIA ON ddn 

nnnnnn 

(3 

If you have a crash driver loaded, you can obtain a crash dump now by 
pressing the P key followed by RETURN. 



1.5 RUNNING CD A 

There are several ways to run CDA, and you can run it as either an 
installed or an uninstalled task. Also, you can run CDA from either 
the DCL or MCR command line interpreter (CLI). This section describes 
the alternative ways of running CDA. 

If CDA is an installed task on your system, you can enter the CDA 
command line at the CLI prompt. After CDA processes your command, the 
CLI prompt returns. In the following example, MCR is the CLI: 

>CDA CRASH_DUMP.LST,COPY.CDA= [1,54]/STB,DR5: (U) 

> 

If CDA is installed and you want to enter commands directly to CDA, 
you can invoke the command level of the CDA utility by typing CDA and 
a carriage return. When you are finished using CDA, you exit from CDA 
by pressing CTRL/Z , which returns control to the CLI. In the 
following example, DCL is the CLI: 

$ CDA (ret) 

CDA>command line (ret) 

CDA>command line (r|t) 
CDA>~Z 
$ 
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If CDA is an uninstalled task, the system has to find and install the 
CDA task image file before it can run CDA. Therefore, the command you 
use depends upon the location of the CDA task image file (CDA.TSK) . 
If CDA.TSK is in the system UFD or the system library, type: 

RUN $CDA (US 

CDA > command line (ret) 

CDA> 

On RSX-11M operating systems, you can use the RUN $CDA command only if 
CDA.TSK is present in the UFD that corresponds to the system UIC on 
device LB:. On RSX-11M-PLUS operating systems, CDA.TSK must be 
present in the UFD that corresponds to the library UIC. 

If CDA.TSK is present in the UFD that corresponds to the current UIC 

on the default system device (the current UFD for the terminal from 

which the command is entered) , you can run CDA by typing the following 
command : 

RUN CDA (re?) 

CDA> command line (ret) 

Finally, you can run CDA by using the DCL ANALYZ E/ CRASH_DUMP command: 

$ ANALYZ E/CRASH_DUMP (RET) 

If your CLI is MCR, but your terminal also supports DCL, you can run 
the ANALYZ E/CRASH_DUMP command by typing DCL and a space before the 
command. For example: 

>DCL ANALYZ E/CRASH_DUMP (RET) 

Chapter 2 shows you how to use CDA command lines and the 
ANALYZE/CRASH DUMP command. 



1.6 INDIRECT COMMAND FILES 

As with other utilities, you can enter CDA command lines directly from 
the terminal or from an indirect command file. However, CDA indirect 
command files must not contain a reference to another command file. 



1.7 BASIC CRASH DUMP ANALYZER OUTPUT LISTING 

While the Crash Dump Analyzer provides many output listing options, 
fundamental system information appears on the first six pages of 
output listing (you can suppress this information by using the /-SYS 
switch, which is described in Chapter 2) . The first six pages of 
output listings contain the following information: 



Page 


1 


— Volatile registers 


Page 


2 


— Kernel stack 


Page 


3 


-- System common 


Page 


4 


— System common labeled dump 


Page 


5 


— Pool statistics 


Page 


6 


-- Assign table 



Sections 3.1.1 through 3.1.6 describe these pages in detail. 
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The system information section also includes three more pages if the 
relevant information is in memory at the time of the crash. These 
pages display group-global event flags, error log packets, and, on 
RSX-11M-PLUS systems, the contents of low core memory. Section 3.1.7 
describes the group-global event flag page, Section 3.1.8 describes 
the error log page, and Section 3.1.9 describes the RSX-11M-PLUS low 
core memory page that is part of the system common dump. 
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CHAPTER 2 
COMMAND LIMES 



CDA commands control how the Crash Dump Analyzer processes a memory 
dump and how it formats the output listings that it generates. You 
can use CDA command lines to enter commands directly to the CDA 
utility or, if your terminal supports the DIGITAL Command Language 
(DCL) , you can use the DCL ANALYZE/CRASH_DUMP command to run CDA. 
This chapter describes CDA command lines and the ANALYZE/CRASH_DUMP 
command by showing the format of the command lines, the command 
specifications and qualifiers, and examples of how the commands work. 



2.1 CDA COMMAND LINES 

This section shows the CDA command line format, lists and describes 
command line switches, and provides some examples of CDA command 
lines . 

The CDA command line has the following format: 

CDA> [listf ile/sw] , [binaryf i le/sw] = [symbol file/STB] , crash- input [/sw] 

The CDA command line specifies the input to CDA and the output from 
CDA. The specifications to the left of the equal sign in the command 
line are output specifications, and those on the right side of the 
equal sign are input specifications. 

You must include at least one output specification and one input 
specification in the command line. For output from CDA, you can 
specify a list file only, a binary file only, or both a list file and 
a binary file. For input to CDA, you must specify the crash-input, 
but the symbol file specification is optional. 

Output file specifications are position dependent. Position dependent 
means that when you include both output specifications, you must place 
them in the positions shown in the command line. If you omit the list 
file, you must place a comma before the binary file specification. 

Input file specifications are position independent and can appear in 
either order. 

The remainder of this section describes CDA command line 
specifications . 

Output Specifications: 

listf ile 

The output specification of the formatted CDA analysis listings. 
You can use either a device or a file as the list file 
specification. If you specify a file, CDA creates the file and 
writes the output listings to the file. By default, CDA then 



2-1 



COMMAND LINES 



spools the file to the system line printer queue, unless you 
specify otherwise. If you specify a device for the list file, 
CDA displays or prints its output listings on that specific 
device. For example, if you specify your terminal (TTnn: or 
TI : ) as the list file, CDA displays the output listings on your 
terminal. Chapter 3 describes the analysis listings that CDA 
generates . 

binaryf ile 

The file specification for the optional binary file. This file 
is a copy of the binary data that the crash dump routine wrote on 
the crash dump device. It allows you to selectively create an 
historical record of crash dumps. If you create this file during 
an initial analysis, you can use it for input to CDA at a later 
time. Since the crash dump routine overwrites the information on 
the crash dump volume with each successive dump, this feature 
allows you to use a single volume for all crash dumps. 

If the crash dump device on your system is a secondary storage or 
sequential device, you can reduce CDA analysis time by copying 
the crash input to a binary file on another device. Then you can 
use the binary file as input to CDA for analysis. 

Input Specifications: 

symbol file/STB 

The file specification of the symbol table file for the crashed 
system. The /STB switch is an integral part of this file 
specification, because CDA uses the data in the symbol table file 
to format the binary memory dump into readable formats. If you 
omit this file specification and switch, CDA uses the default 
symbol table file, which is the file named RSXllM.STB in the UFD 
that corresponds to the current UIC. 

crash-input 

The source of the binary input to CDA. This specification can be 
either a device name (the crash dump device) or a binary file 
that was created during a previous CDA analysis. However, if the 
crash-input specification is a binary file, you cannot also 
include a binary file output specification in the command line. 

Switches: 

/sw 

An optional CDA switch. The list file, binary file, and 
crash-input file specifications can include optional switches 
that modify CDA action. Each specification in the command line 
has its own switches. Section 2.1.1 describes the CDA switches 
and lists which specification they apply to. 

File specifications in the CDA command line can appear in complete 
Files-11 format, with device name, UFD, file name, file type, and 
version number. When you omit any of these elements, CDA uses the 
defaults shown in Table 2-1. However, not all of the elements in file 
specifications have defaults. 
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Table 2-1 
File Default Values 



File 


Device 


UFD 


Default 
File Name 


Value 
File Type 


List file 


SY: 


Current 


None 


. LST 


Binary file 


SY: 


Current 


None 


. CDA 


Symbol file/STB 


SY: 


Current 


RSX11M 


.STB 


Crash-input 


SY: 


Current 


None 


.CDA 



See Section 2.1.2 for examples of CDA command lines, which include 
examples that show how CDA uses default file types. 



2.1.1 CDA Command Line Switches 

Two kinds of command line switches, analysis switches and function 
switches, allow you to control CDA operation. 

Analysis switches determine which analysis routines CDA applies to the 
crash input. Thus, you can select the types of data that you want CDA 
to output. For example, analysis switches can list information about 
all of the devices in the system, or they can list information about 
active devices only. 

Function switches provide a number of options for controlling CDA 
output. For example, function switches can terminate an analysis 
after CDA encounters a specified number of errors, or they can limit 
the number of pages of output listings. 

Both types of switches are file specific. That is, each switch 
applies to a particular file and may not be used without that file or 
with any other file. 



2.1.1.1 Analysis Switches - Table 2-2 summarizes the analysis 
switches and gives brief descriptions of their effects. Some of the 
switches in Table 2-2 have synonyms or alternate mnemonics. These are 
shown under each switch. Expanded descriptions of each switch follow 
the table. 



Table 2-2 
Summary of CDA Analysis Switches 



Applies to 

Switch Function File 



/ACT Lists the contents of the Task Crash-input 

/ATL Control Block (TCB) for each 

active task 

/ADV Lists information for all Crash-input 

devices in the system 
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Table 2-2 (Cont.) 
Summary of CDA Analysis Switches 



Switch 



Function 



Applies to 
File 



/ALL 

/CLI 
/CPB 

/CLQ 
/CTL 



/DEV 
/DCB 
/SCB 
/UCB 

/DUMP: a :b: [c] 
/DMP : a :b : [c] 



/HDR 



/KDS:a:b 



/KIS:a:b 



/PCB 
/PAR 

/POOL 



/SEC POL 



/-SYS 



/TASK : name : a :b 
/TAS : name: a :b 
/TSK:name :a :b 



Lists the output of all 
analysis routines 

Lists the contents of the CLI 
Parser Blocks in the system 

Lists the contents of the 
clock queue 

Lists information for each 
device controller 

Lists information for all 
active devices in the system 



Lists the contents of physical 
memory between address a and 
address b; (c is an optional 
virtual starting address) 

Lists the contents of the task 
headers for each task resident 
in memory 

Lists the contents of the 
kernel data space from virtual 
address a to virtual address b 
(RSX-llM-PLUS systems only) 

Lists the contents of kernel 
instruction space from virtual 
address a to virtual address b 
(RSX-llM-PLUS systems only) 

Lists the contents of each 
Partition Control Block 



Lists the contents 
system's pool 



of the 



Lists the contents of system 
secondary pool (RSX-llM-PLUS 
systems only) 

Suppresses listing of the 
system information 

Lists the contents of task 
"name" between virtual address 
a and virtual address b; lists 
the contents of task data 
space (if task includes data 
space) on RSX-llM-PLUS 



Crash- input 
Crash-input 
Crash- input 
Crash- input 
Crash- input 

Crash-input 

Crash-input 
Crash-input 

Crash-input 

Crash- input 
Crash- input 
Crash-input 

Crash-input 
Crash-input 



(Continued on next page) 



2-4 



COMMAND LINES 



Table 2-2 (Cont.) 
Summary of CDA Analysis Switches 



Switch 



Function 



Applies to 
File 



/TCB 
/TAL 
/STD 

/TDS:name:a:b 



/t IS: name: a :b 



Lists the contents of the TCB 
for every task in the System 
Task Directory 

Lists the contents of task 
data space (RSX-llM-PLUS only) 

Lists the contents of task 
instruction space (RSX-llM-PLUS 
systems only) 



Crash-input 

Crash-input 
Crash-input 



/ACT or /ATL (Task Control Blocks for Active Tasks) 
File: Crash-input 

Effect: CDA lists the contents of the Task Control Block (TCB) 
for each active task. 

/ADV (All Devices) 

File: Crash-input 

Effect: CDA lists the contents of the control blocks for all 
devices in the system. To list active devices, use the /DEV 
switch. 

/ALL (All Analysis Routines) 
File: Crash-input 

Effect: CDA applies all of its analysis routines (except those 
associated with memory and task dumps) to the specified 
crash-input. The output from these routines is listed in the 
following order: 

1. System information 

2. Active tasks information 

3. Task headers information 

4. Partition information 

5. Common Block Directory entries 

6. Device information 

7. Clock queue contents 

8. Device controller information 

9. Pool contents 
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/CLI or /CPB (Command Line Interpreter Parser Blocks) 
File: Crash-input 

Effect: CDA lists the contents of all Command Line Interpreter 
Parser Blocks (CPBs) in the system. 

/CLQ (Clock Queue) 

File: Crash-input 

Effect: CDA lists the contents of the clock queue. 
/CTL (Device Controllers) 
File: Crash-input 

Effect: CDA lists the contents of the controller table and 
Controller Request Block (KRB) for each device controller in the 
system. 

/DEV, /DCB , /SCB, or /UCB (Devices in System) 
File: Crash-input 

Effect: CDA scans the system device tables and lists the 
contents of the control blocks for each active device in the 
system. To list all devices, use the /ADV switch. 

/DUMP:a:b: [c] or /DMP (Physical Memory) 

File: Crash-input 

Effect: If only a and b are specified, CDA dumps the contents of 
physical addresses a through b inclusive and labels them with 
their physical addresses. If a, b, and c are specified, CDA 
dumps the contents of physical addresses a through b, but labels 
them with dummy virtual addresses, starting at the address 
specified by c. 

CDA allows you to specify a virtual starting address because 
RSX-11M and RSX-11M-PLUS systems use physical memory in terms of 
virtual addresses. If you dump physical memory labeled with the 
corresponding virtual addresses, you do not have to translate 
physical addresses to virtual addresses as you read the dump. 

/HDR (Headers for Memory-Resident Tasks) 

File: Crash-input 

Effect: CDA lists the contents of the task headers for each task 
resident in memory. 

/KDS:a:b (Kernel Data Space) 

File: Crash- input 

Effect: CDA lists the contents of kernel data space between the 
virtual addresses a and b inclusive. 

/KIS:a:b (Kernel Instruction Space) 

File: Crash-input 

Effect: CDA lists the contents of kernel instruction space 
between the virtual addresses a and b inclusive. 
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/PCB or /PAR (Partition Control Blocks) 
File: Crash-input 

Effect: CDA outputs a map that lists all the occupants of memory 
and the contents of each Partition Control Block (PCB) . 

/POOL:a:b (System Pool) 

File: Crash-input 

Effect: CDA lists the system pool in octal, Radix-50, and ASCII. 
/SECPOOL[:a:b] (Secondary Pool) 
File: Crash-input 

Effect: Lists the contents of the secondary pool on RSX-11M-PLUS 
systems. 

/STD, /TCB , or /TAL (System Task Directory) 
File: Crash-input 

Effect: CDA lists the contents of all of the Task Control Blocks 
in the System Task Directory (STD) at the time of the crash. 

/-SYS (System Information) 

File: Crash-input 

Effect: CDA suppresses the system information listing. 
/TASK: name: a :b, /TAS, or /TSK (Task Virtual Address Space) 
File: Crash-input 

Effect: CDA lists the virtual address space from the 16-bit 
virtual address a through b for the task specified by "name." If 
you do not specify addresses, CDA lists the task's entire virtual 
address space. 

/TDSrname [ :a :b] (Task Data Space) 

File: Crash-input 

Effect: CDA lists the contents of the task data space between 
the virtual addresses a and b inclusive. If you do not specify 
addresses, CDA lists the entire task data space. 

/TIS:name:a:b (Task Instruction Space) 
File: Crash-input 

Effect: CDA lists the contents of the task instruction space 
between the virtual addresses a and b inclusive. If you do not 
specify addresses, CDA lists the entire task instruction space. 



2.1.1.2 Function Switches - Table 2-3 summarizes the function 
switches and gives brief descriptions of their effects. Expanded 
descriptions of each switch follow the table. 
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Table 2-3 
Summary of CDA Function Switches 



Switch 



Function 



Applies to 
File 



Default 



/BL:n 



/DENS : n 

: HIGH 
:LOW 

/EXITrn 



/LIMIT : n 
/LINES :n 
/MEMSIZ:n 

/KMR 

/-SP 
/STB 



Identifies the starting block 
number of the crash-input device; 
the value of n must be less 
than 65535. 

Sets density of crash input tape 
to 800 or 1600 bits per inch 
(bpi) 

Terminates analysis after 

encountering n analysis errors 

Limits output listing to n pages 

Limits page length to n lines 

Saves nKb memory from crash in a 
binary file 

Forces the assignment of kernel 
address register values for the 
crashed system 



Does not 
1 ist ing 



print analysis output 



Identifies the file specifica- 
tion that contains the Executive 
symbol table 



1. n can be expressed as an octal or decimal 
point (.) following the number denotes decimal. 



Crash- n=l 
input 



Crash- n=800 
input 

List file 

List file n=300, 

List file n=60. 

Binary n=124, 
file 

Crash- /-KMR 
input 

List file /SP 
Symbol file 

number. A decimal 



/BL:n (Identify Starting Block Number) 
File: Crash-input 

Effect: CDA reads the dump from the input device beginning at 
block n. If the crash dump device is not a disk or a DECtape, 
CDA ignores this switch. 

Default: n = 1 

/DENS : n (Sets Tape Density) 

: HIGH 
:L0W 

File: Crash-input 

Effect: CDA reads the crash input tape at the density specified: 
800 or 1600 bpi. You can also use LOW to indicate 800 bpi or 
HIGH to indicate 1600 bpi. 



Default: n=800 
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/EXITrn (Exit After n Errors) 
File: List file 

Effect: CDA maintains an error count. As it encounters 
inconsistencies in the system data structures, it increments this 
count. If you specify the /EXIT:n switch, CDA terminates 
analysis after n errors. If you specify the /EXIT switch but do 
not specify n, CDA exits after one error. 

Default: CDA runs to completion. 

/LIMIT :n (Limit Output Listing) 

File: List file 

Effect: The /LIMIT :n switch limits the number of pages of 
analysis output. When CDA has generated n pages, it terminates 
the analysis and prints a message on the user terminal indicating 
that it has done so. 

Default: n = 300. 

/LINES : n (Print n Lines per Page) 

File: List file 

Effect: This switch lets you specify the number of lines you 
want CDA to print per page. After n lines are printed, a new 
page is ejected. 

Default: n=60. 

/MEMSIZ:n (Establish Size of Binary Output File) 

File: Binary file 

Effect: This switch causes CDA to create a binary output file 
4*n blocks long and to transfer nKb words to it from the 
crash-input file. The value of n must be greater than 16. 

This switch is particularly useful when transferring binary crash 
dumps from disk or DECtape . Since disks and DECtapes have no 
physical EOFs, it is necessary to specify the size of the actual 
memory dump. 

When the crash input resides on magnetic tape, the binary output 
file is filled with zeroes if the EOF is read before nKb words 
are transferred. 

Default: n = 124. 

/KMR (Assign Kernel Mapping Register Values) 

File: Crash-input 

Effect: On mapped systems, when CDA reads incorrect Page Address 
Register (PAR) values from the crash stack, it aborts the 
analysis and prints an error message on the terminal. If this 
happens, you can use the /KMR switch to retry the analysis. When 
you specify /KMR, CDA uses standard mapping values to convert 
kernel virtual addresses to physical memory addresses. 

Default: CDA uses existing Page Address Registers. 
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/-SP (Do Not Spool) 

File: List file 

Effect: CDA does not spool the analysis output listing to the 
system line printer queue. Instead, it creates an output list 
file on the device indicated in the output file specification. 
If you do not specify a device in the output file specification 
when you use the /-SP qualifier, CDA creates the output list file 
on SYO: . 

Default: /SP 

/STB (File Specified Contains the Executive Symbol Table) 
File: Symbol file (RSX11M.STB) 

Effect: The /STB switch identifies a file containing the 
Executive symbol table. This file must correspond to the crashed 
system. CDA opens the symbol file and extracts the necessary 
symbol values. If it fails to find any required symbol values, 
CDA aborts the analysis and returns an error message. 

Default: [current UIC] RSX11M. STB 



2.1.2 CDA Command Line Examples 

The following examples illustrate CDA command lines. Assume that the 
user in these examples is logged in under UIC [301,356], that the 
crash dump device is DR5:, and that CDA is running as an installed 
task. Also, note how CDA uses default file types. 

Example 1 

>CDA (RET) 

CD A> DUMP, DUMP=RSX11M. STB/STB , DR5: (@n) 
This command line creates: 

• A list file, DUMP.LST, in UFD [301,356], which is printed 
automatically 

• A binary file, DUMP. CDA, in UFD [301,356] 

CDA reads the binary crash dump input from the crash dump device 
(DR5:), makes a binary copy of the crash dump input named DUMP. CDA, 
analyzes the crash dump input according to the information in the 
Executive symbol table file named RSX11M.STB in UFD [301,356], and 
writes a formatted output listing to a file named DUMP.LST. CDA then 
spools DUMP.LST to the system line printer queue. 

Example 2 

>CDA (RET) 

CDA> ,DUMP= [1, 54]/STB,DR5: © 

This command line creates a binary file named DUMP. CDA in UFD 
[301,356] . 

CDA reads the binary crash dump input from DR5: and analyzes it 
according to the information in the Executive symbol table file, which 
is named RSXllM.STB in UFD [1,54]. 
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Example 3 

>CDA LP : = [ 1 , 54 ] /STB , DUMP (ret) 
> 

This command line creates an output listing on device LP:. 

CDA reads the binary input from a previously created binary file named 
DUMP. CDA, and analyzes it in accordance with the information contained 
in the Executive symbol table file named RSX11M.STB in UFD [1,54]. 
The CDA output listings are then printed on LP:. 

This command line is also an example of a CDA command that is issued 
from the CLI prompt. Thus, the CLI prompt returns after the command 
is issued. 

Example 4 

>CDA TI:=DUMP (H) 
> 

This command line creates an output listing that is displayed on the 
terminal from which the command was issued. 

CDA reads the binary input from a previously created binary file named 
DUMP. CD A and analyzes it according to the information in the default 
symbol table file, (the file named RSX11M.STB in the UFD that 
currently corresponds to UIC [301,356]). The CDA output listings are 
then displayed on TI:. 



2.2 THE DCL ANAL YZ E/CRASH_DOMP COMMAND 

If your terminal supports the DIGITAL Command Language (DCL) command 
line interpreter, you can run the CDA utility by using the DCL 
ANALYZE/CRASH_DUMP command as an alternative to the CDA command line. 
This section describes the ANALYZE/CRASH_DUMP command line format and 
qualifiers. The section concludes with some examples of 
ANALYZE/CRASH_DUMP command lines. 

The ANALYZE/CRASH_DUMP command line has the following format: 

ANALYZE/CRASH_DUMP [/qualifiers] crash- input [/qualifiers] 

You use the ANALYZE/CRASH_DUMP command to specify CDA input and 
output., The command qualifiers that you place immediately after the 
command name specify the CDA output files and, optionally, the symbol 
table file that CDA uses to process the crash dump input. The 
crash-input specification is mandatory because it directs CDA to the 
source of the binary crash dump input. 

Output Specifications: 

You must specify at least one of the following command qualifiers as 
an output specification in the command line: 

• /LIST: Specifies the output list file 

• /BINARY: Specifies a binary copy of the crash-input file 



• /SYMBOLS: 



Specifies the symbol definition file 
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You can specify /LIST: only, /BINARY: only, or /LIST: and /BINARY: 
together. You can optionally specify /SYMBOLS: with any combination 
of the /LIST: and /BINARY: qualifiers. However, if you do specify 
/SYMBOLS, you must include at least one of the other command 
qualifiers (because the symbol definition file is not an output file; 
it is used by CDA to generate an output file). Section 2.2.1.1. 
provides complete descriptions of the functions of each of the command 
qual if iers . 

If you omit the crash-input specification from the command line, CDA 
prompts you for it, as shown in the following example: 

$ ANALYZE/CRASH_DUMP/LIST : LP : (ret) 
Crash input? DR5: (fig) 

If you enter the command name only, CDA prompts you for input and 
output, as shown in the following example: 

$ ANALYZE/CRASH_DUMP (fig) 

Crash output? /LIST:SY: [301, 356] CRASH . LST :/BINARY :COPY. CDA (© 
Crash input? DUMP .CDA (fig) 

Note that if you enter an output file in this way, you must include 
the /LIST: or /BINARY: qualifiers as part of the output file 
specification . 

Input Specification: 

crash-input 

Specifies the location of the binary input to the 
ANALYZE/CRASH_DUMP command. The crash-input specification can be 
the name of the crash dump device, or it can be a binary file 
that was created during a previous crash dump analysis. 

When you enter an ANALYZE/CRASH_DUMP command line, you can include 
command qualifiers, qualifiers for the crash-input parameter, or both. 
Section 2.2.1 describes qualifiers. 



2.2.1 ANALYZE/CRASH_DDMP Command Qualifiers 

You can control the way CDA processes the crash input and how it 
formats the output listings by using command qualifiers in the command 
line. You can select the information that you want in the CDA output 
listings by using qualifiers for the crash-input specification. 
Section 2.2.1.1 describes command qualifiers. Section 2.2.1.2 
describes the qualifiers that you can use when you specify the crash 
input . 



2.2.1.1 Command Qualifiers - You can use command qualifiers with the 
ANALYZE/CRASH_DUMP command to control how CDA processes the binary 
crash-input, and how it formats the output analysis listings. You 
place command qualifiers immediately after the command name in the 
command line. Table 2-4 summarizes the command qualifiers and gives 
brief descriptions of their effects. Expanded descriptions of each 
qualifier follow the table. 
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Table 2-4 

Summary of ANAL YZ E/CRASH_DUMP Command Qualifiers 



Command Qualifier 



Function 



Applies to 
File 



/LIST:listf ile [/qualifiers] 



listfile qualifiers: 



Specifies the output List file 
list file or device 



/PAGE_COUNT:n 
/PAGE_LENGTH:n 

/[NO] PRINTER 

/BINARYrbinaryf ile [/qual] 

binaryfile qualifier: 
/MEMORY_S I ZE : n 

/SYMBOLS :symbolf ile 



Specifies an error 
limit at which CDA 
analysis terminates 

Specifies the number 
of output pages 

Specifies the number 
of output lines per 
page 

Specifies whether 
the output should be 
printed on the 
system line printer 

Specifies an optional 
copy of the binary 
input file 



Copies nKb words of 
memory from a crashed 
system 



List file 

List file 
List file 

List file 
Crash- input 



Crash- input 



Specifies the symbol Crash-input 
definition file 



Command Qualifier Descriptions: 

/LISTrlistf ile [/qualifiers] 

/ERROR_LIMIT [ :n] 
/PAGE_COUNT:n 
/PAGE_LENGTH:n 
/[NO] PRINTER 

File: List file 

Effect: Specifies the optional formatted CDA output list 
file. This list file consists of the analysis report listings 
that are described in Chapter 3. You can also specify a device 
for the list file, in which case CDA displays or prints its 
output listings on the specified device. You can control the 
list file output by using the following file qualifiers. 
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List File Qualifiers: 

/ERROR_L I M I T [ : n ] 

Effect: CDA maintains an error count. As it encounters 
inconsistencies in the system data structures, it 
increments the error count. CDA terminates the crash dump 
analysis when it finds the number of errors that you 
specify with this qualifier. If you use the /ERROR_LIMIT 
qualifier without specifying a number, the crash dump 
analysis terminates after one error. 

Default: CDA runs the analysis until it is completed. 
/PAGE_COUNT : n 

Effect: This qualifier limits the number of pages of 
analysis output. When CDA has generated n pages, it 
terminates the analysis and prints a message on the 
terminal indicating that the analysis has terminated. 

Default: Analysis terminates after 300 pages. 

/PAGE_LENGTH:n 

Effect: This qualifier lets you specify the number of 
lines that you want CDA to print per output page. After 
the specified number of lines are printed, CDA breaks to a 
new page. 

Default: CDA prints 60 lines per page. 
/[NO] PRINTER 

Effect: This qualifier prevents the printing of the 
analysis output on the system line printer. Instead, CDA 
creates the output list file on the device in the list 
file specification. If a device is not specified in the 
list file specification, CDA creates the output file on 
the default user disk (SYO:). 

Default: CDA prints all output on the system line 
pr inter . 

/BINARY : binary f ile [/qualifier] 

/MEMORY_S I Z E : n 

File: Crash-input 

Effect: Specifies that an optional binary file should be 
created. This file is a copy of the binary data that the crash 
dump routine wrote on the crash dump device. If you create the 
file during an initial analysis, you can use it as input to the 
ANALYZE/CRASH_DUMP command at a later time. Also, because the 
crash dump routine overwrites the contents of the crash dump 
volume with each crash dump, this qualifier allows you to save 
the results of crash dumps. You can then reuse the same volume 
for successive crash dumps while maintaining a record of 
previous crash dumps. 
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Binary File Qualifier: 
/MEMORY_S I ZE : n 

Effect: Specifies memory size for the binary copy of the 
crash dump input file. You specify n, where n is the 
number of Kb words. CDA then creates a binary file 4n 
words long and transfers nKb words to it from the 
crash-input file. The value of n must be greater than 
16 (decimal) . 

Default: n=124 

/SYMBOLS : symbol f i le 

File: Symbol definition file 

Effect: Specifies the symbol definition file for the crashed 
system, which contains the Executive symbol table. The symbol 
file must correspond to the crashed system. CDA opens the file 
and extracts the necessary symbol values. If it fails to find 
any required symbol values, CDA aborts the analysis and returns 
an error message. If you omit this file specification, CDA 
uses the default file, which is the file named RSX11M.STB in 
the UFD that corresponds to the current UIC. 



2.2.1.2 Crash-input File Qualifiers - You can select the analysis 
listings that you want CDA to output by using qualifiers for the 
crash-input file specification in the ANALYZE/CRASH_DUMP command 
line. Table 2-5 summarizes the crash-input qualifiers and gives 
brief descriptions of their effects. Expanded descriptions of each 
qualifier follow the table. 



Table 2-5 

Summary of ANALYZE/CRASH DUMP Crash-input Qualifiers 



Qualifier or Argument 



Function 



Applies to 
File 



/ACTIVE: (arg [,...]) 

/ACTIVE arguments: 
DEVICES 

TASKS 

/ALL 

/BLOCK :n 



Lists data on active 
tasks and/or devices 



Lists data about 
active devices 

Lists contents of the 
Task Control Blocks 
for active tasks 

Lists all available 
crash dump data 

Specifies the block 
number where crash 
dump begins on the 
crash dump device 



Crash- input 

Crash- input 
Crash- input 

Crash-input 
Crash-input 



(Continued on next page) 
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Table 2-5 (Cont.) 
Summary of ANALYZE/CRASH DUMP Crash-input Qualifiers 



Qualifier or Argument 



Function 



Applies to 
File 



/CLOCK_QUEUE 
/CONTROLLERS 

/DATA_STRUCTURES : (arg [,...]) 

/DATA_STRUCTURES arguments: 
COMMAND PARSER 



DEVICE 
STATUS 
UNIT 

PARTITION 



TASK 

/DENSITY : n 
/DEVICES 

/DUMP [ : (START :n , END : n , ADDRESS : n) 
/HEADERS 

/KERNEL: (arg [,...]) 
/KERNEL arguments: 

DATA : (START :n, END :n) 

INSTRUCTION: (START : n r END : n) 
REGISTERS 



Lists the contents of Crash-input 
the clock queue 



Lists device 
controller data 

Specifies which data 
structures are to be 
formatted and listed 



Lists contents of 
CLI Parser Blocks 

List contents of the 
control blocks for 
active devices 

Lists contents of 
Partition Control 
Blocks 

Lists contents of the 
Task Control Blocks 
for tasks in the STD 



Crash- input 



Crash- input 



Crash-input 
Crash- input 

Crash- input 

Crash- input 



Specifies bits per 
inch for input device 

Lists contents of all 
Device Control Blocks 

Lists contents of 
physical addresses 

Lists contents of 
resident task headers 



Crash- input 
Crash- input 
Crash- input 
Crash- input 
Lists kernel contents Crash-input 



Lists contents of 
kernel data space 

Lists contents of 
kernel instruction 
space 

Forces assignment of 
values for the kernel 
address registers 



Crash-input 
Crash-input 

Crash- input 



(Continued on next page) 
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Table 2-5 (Cont.) 
Summary of ANALYZE/CRASH_DUMP Crash- input Qualifiers 



Qualifier or Argument 


Function 


Applies to 
File 


/PARTITION 


Lists contents of 
Partition Control 
Blocks 


Crash-input 


/POOL : (START : n , END : n) 


Lists pool contents 


Crash-input 


/SECONDARY_POOL [ : (START :n , END: n) ] 


Lists contents of 
secondary pool from 
START to END 


Crash- input 


/ [NO] SYSTEM 


Suppresses listing of 
system information 


Crash- input 


/TASKS : (arg [,...]) 


Lists task data 


Crash-input 


/TASKS arguments: 






DIRECTORY 


Lists contents of the 
Task Control Blocks 
for tasks in the STD 


Crash- input 


ADDRESS: (NAME : name [ , START :n , END :n] ) 


Lists contents of 
task addresses from 
START to END 


Crash-input 


DATA: (NAME: name [ ,START:n,END:n] ) 


Lists contents of 
task data space 


Crash- input 


INSTRUCTION: (NAME: [ , START : n , END : n] ) 


Lists contents of 
task instruction space 


Crash-input 



File Qualifier Descriptions: 

/ACTIVE: (arg [, . . . ] ) 

DEVICES 
TASKS 



File: Crash-input 

Effect: Lists data on active tasks and devices. 

/ACTIVE arguments: 

DEVICES 

Effect: Lists data on the devices active in the system at 
the time of the crash. If you want CDA to list data on all 
of the devices known to the system at the time of the crash, 
use the /DEVICES qualifier. 

TASKS 

Effect: Lists the contents of the Task Control Blocks of 
active tasks. If you want CDA to list the contents of the 
Task Control Blocks of all installed tasks, both active and 
dormant, use the /TASKS : (DIRECTORY) qualifier. 
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/ALL 

File: Crash-input 

Effect: Analyzes all information available in the crash dump 
file (except the information associated with memory and task 
dumps). CDA lists the output in the following order: 

1. System information 

2. Active tasks information 

3. Task headers information 

4. Partition information 

5. Common Block Directory entries 

6. Device information 

7. Clock queue contents 

8. Device controller information 

9. Pool contents 
/BLOCK :n 

File: Crash-input 

Effect: Identifies the starting block number of the crash dump 
file on the crash input device. The value of n must be less than 
65535 (decimal) . 

/CLOCK_QUEUE 

File: Crash-input 

Effect: Lists the contents of the system clock queue. 
/CONTROLLERS 

File: Crash-input 

Effect: Lists the contents of the controller table and 
Controller Request Block (KRB) for each device controller in the 
system . 

/DATA_STRUCTURES : (arg [ , . . . ] ) 

COMMANDPARSER 

DEVICE 

PARTITION 

STATUS 

TASK 

UNIT 

File: Crash-input 

Effect: Selects which system data structures CDA will format and 
list. 
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/DATA_STRUCTURES arguments: 
COMMAND_PARSER 

Effect: Lists the contents of the Command Line Interpreter 
(CLI) Parser Blocks. 

PARTITION 

Effect: Lists the contents of the Partition Control Blocks. 

TASK 

Effect: Lists the contents of the Task Control Block for 
every task in the System Task Directory (all installed 
tasks) at the time of the system crash. 

DEVICE 

Effect: Lists the contents of the Device Control Blocks for 
active devices. 

STATUS 

Effect: Lists the contents of the Status Control Blocks for 
active devices. 

UNIT 

Effect: Lists the contents of the Unit Control Blocks for 
active devices. 

/DENSITY:n 

File: Crash-input 

Effect: Causes a crash input tape to be read at the density 
specified, 800 or 1600 bpi. The default is 800 bpi . 

/DEVICES 

File: Crash-input 

Effect: Lists the contents of the control blocks for all devices 
in the system. To list only active devices, use the 
/ACTIVE: (DEVICES) qualifier. 

/DOMP[: (START : a, END :b[, ADDRESS :c] ) ] 

File: Crash-input 

Effect: Lists the contents of physical addresses a through b 
inclusive and labels them with their physical addresses. If you 
include address c, the /DUMP qualifier dumps the contents of 
physical addresses a through b, but labels them with dummy 
virtual addresses, starting at c. 

/HEADERS 

File: Crash-input 

Effect: Lists the contents of the task headers for each task 
re;sident in memory. 
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/KERNEL: (arg [,...]) 

DATA: (START :n , END:n) 
INSTRUCTION: (START :n , END :n) 
REGISTERS 

File: Crash-input 

Effect: Lists kernel data. 

/KERNEL arguments: 

DATA: (START :n, END :n) 

Effect: Lists the contents of kernel data space from 
virtual addresses START :n to END:n, 

INSTRUCTION: (START :n, END :n) 

Effect: Lists the contents of kernel instruction space from 
virtual address START : n to ENDrn. 

REGISTERS 

Effect: Forces the assignment of the kernel address 
register values for the crashed system. 

/PARTITION 

File: Crash-input 

Effect: Lists the contents of the Partition Control Blocks. 
/POOL: (START: n , END: n) 

File: Crash-input 

Effect: Lists the contents of system pool between the addresses 
specified in octal, Radix-50, and ASCII. 

/SECONDARY_POOL : (START : n , END : n ) ] 

File: Crash-input 

Effect: Lists the contents of system secondary pool between the 
addresses specified by START and END. 

/[NO] SYSTEM 

File: Crash-input 

Effect: The /NOSYSTEM qualifier suppresses the system 
information listing. The default action of CDA is /SYSTEM; that 
is, it lists the system information. 

/TASKS: (arg[, . . . ] ) 

DIRECTORY 

ADDRESS : (NAME : name , START : n , END : n ) 
DATA: (NAME : name [ ,START:n, END: n] ) 
INSTRUCTION: (NAME: name [ , START :n, END :n] ) 

File: Crash-input 

Effect: Lists task data. 
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/TASKS arguments: 
DIRECTORY 

Effect: Lists the contents of the Task Control Block for 
every task in the System Task Directory (all installed 
tasks) at the time of the system crash. 

ADDRESS: ( NAME : name , START : n , END : n ) 

Effect: Lists the contents of the task specified by NAME 
between the virtual addresses specified by START and END. 
Includes the contents of task data space if a task includes 
data space. 

DATA : (NAME : name [ , START : n , END : n ] ) 

Effect: RSX-llM-PLUS operating systems only. Lists the 
contents of task data space for the task specified by NAME. 

INSTRUCTION: ( NAME: name [, START :n, END :n] ) 

Effect: RSX-11M-PLUS operating systems only. Lists the 
contents of task instruction space for the task specified by 
NAME. 



2.2.2 ANALYZE/CRASH_DUMP Command Examples 

The following examples illustrate the ANALYZE/CRASH_DUMP command. 
Assume that the user in these examples is logged in under UIC 
[301,356], and that the crash dump device is DR5 : . In this way, you 
can note how CDA uses default file types. Also, assume that CDA is 
running as an installed task. 

Example 1 

$ ANAL YZE/CRASH_DUMP/L I ST : CRASH/BINARY : COP Y/MEMORYS I ZE : 250 DR5: (H) 
This command creates: 

• An output list file named CRASH. LST in the current UFD for UIC 
[301,356] . 

• A binary copy of 250kb words of the crash dump from DR5: (the 
crash dump device) . The copy is named COPY. CDA and is placed 
in the current UFD for UIC [301,56]. 

CDA reads the binary crash dump input from the crash dump device and 
analyzes it according to the default symbol definition file, since a 
symbol definition file is not specified in the command line. CDA uses 
the file named RSX11M.STB in the current UIC as the symbol definition 
file. CDA then generates a list file named CRASH. LST and spools it to 
the default system line printer queue. CDA also copies the specified 
amount of memory from the crash dump device to a binary file named 
COPY. CD A. 

Example 2 

$ ANALYZE/CRASH_DUMP/LIST:LP5:/PAGE_COUNT: 5 DR5:/BL:100 (ret) 
This command creates a list file that is printed on LP5 : . 

CDA reads the crash input from DR5: , beginning at block 100, and 
analyzes it according to the default symbol definition file. CDA then 
prints the first five pages of its output listing on LP5:. 
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Example 3 

$ ANALYZE/CRASH_DUMP/LIST:TI : /SYMBOLS : [1, 54] COPY. CDA (ret) 

This command creates a list file that is displayed on TI : (the 
terminal at which the command was issued) . 

CDA reads the previously generated binary file named COPY. CDA, 
analyzes it according to the file named RSX11M.STB in UFD [1,54], and 
displays its output listings on TI:. 
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ANALYSIS LISTINGS 



The CD A output listings in this chapter illustrate CDA operation. 
Each item of each listing is keyed to the brief explanatory text that 
precedes it. 

Dumps shown in offset mode use relative addresses. They are offset 
from the beginning of the displayed data. They are neither physical 
nor virtual addresses of the data. 



NOTE 

These listings came from several different crash 
dumps. Therefore, values that would usually correlate 
across the various listings do not necessarily 
correlate here. Those listings that extend across 
several pages in an actual dump of a crashed system 
are truncated here and reflect only a typical printout 
format for them. 



3.1 SYSTEM INFORMATION 

The first six pages of a CDA output listing normally contain the 
system information described in Sections 3.1.1 through 3.1.6. The 
system information consists of the following: 

• Volatile registers 

• Kernel stack 

• System common 

• System common alphabetized dump 

• Pool statistics 

• Assign table 

If Group-global Event Flag Blocks are in memory when the system 
crashes, the listing described in Section 3.1.7 appears. If error log 
packets are in memory at the time of the crash, the listing described 
in Section 3.1.8 appears. On RSX-11M-PLUS systems, CDA generates the 
listing of low core memory shown in Section 3.1.9 as part of the 
system common dump. 



3-1 



ANALYSIS LISTINGS 



3.1.1 Volatile Registers 

Figure 3-1 is a listing that reflects the state of the hardware 
registers at the time of the crash. Refer to the appropriate PDP-11 
processor handbook for detailed information on these registers. Each 
item in the following list describes a correspondingly numbered item 
in Figure 3-1. 

Item Description 

1. Contents of Processor Status Word (PSW) and kernel and 
user stack pointers after crash 

2. Program counter and PSW (that the system pushed onto the 
kernel stack) just prior to system crash (These values 
are valid only if the system trapped.) 

3. Contents of general registers 

4. Contents of memory management registers 

5. Contents of Page Address and Page Description Registers 
(See Section 4.1.1 for information on how to interpret 
this information.) 

6. Contents of UNIBUS map registers (This field is 
suppressed if the processor does not have a UNIBUS map.) 

7. Contents of CPU error register that identifies the source 
of the abort or trap that used the vector at location 4 
(on RSX-11M-PLUS systems, this field is suppressed if the 
processor does not have a UNIBUS map.) 

8. Contents of memory system error register (On RSX-11M-PLUS 
systems, this field is suppressed if the processor does 
not have a UNIBUS map.) 

9. Contents of cache control register (On RSX-llM-PLUS 
systems, this field is suppressed if the processor does 
not have a UNIBUS map.) 
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Figure 3-1 Volatile Registers 
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RSX-UM-PLUS CRASH DUMP ANALYZER V3.G 
VOLATILE REGISTERS 
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Figure 3-1 (Cont.) Volatile Registers 
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3.1.2 Kernel Stack 

Figure 3-2 shows the contents of the kernel stack area beginning at 
V$$CTR and ending at $STACK. The kernel stack pointer points to a 
location within this area. See Section 4.1.2 for information on 
interpreting the contents of the kernel stack. 
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Figure 3-2 Kernel Stack 
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3.1.3 System Common 

The listing in Figure 3-3 provides a selective interpretation of some 
of the items in system common. Each item in the following describes 
the corresponding numbered item in Figure 3-3. (Refer to the RSX-11M 
Guide to Writing an I/O Driver or the RSX-11M-PLUS Guide to Writing an 
I/O Driver for further information.) 

Item Description 

1. Time and date of crash, as set in the system 

2. The task that was running at the time of the crash (If no 
task was running, this field contains the null task. 
This condition could develop if all the active tasks are 
blocked at the time of the crash. For information on 
determining which task or driver was mapped at the time 
of the crash, see Section 4.1.1.) 

3. The address of the Task Control Block (TCB) of the 
current task 

4. The contents of the 4-byte system ID indicating system 
base level 

5. The first address available for partitions (the last 
address of the Executive plus 1) 

6. The system size in 32-word blocks and in total words 

7. System UIC 

8. Stack depth count 

9. Contents of the global event flag words 

10. Name of the system for which dump is generated 

11. Network UIC 

12. Device from which the system was booted 

13. Logical block number (LBN) of the beginning of the system 
image 

14. Size of system image file in blocks 

15. The octal value of the system feature masks and the 
meaning of each set bit 

16. Octal dump of system common in offset mode in numerical 
order by address 
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RSX-UM CRASH DUMP ANALYZER V4.2 
SYSTEM COMMON 



19.APR-85 15113 



PACE 3 



CRASH OCCURRED AT 09 1 53l 51 21-MAY-81© 

© ® 
CURRENT TASK s LDR... TCB ADDRESS = 112050„ 

© ® ® 

S8YSID = 30E SEXSIZ = 115000 S3YSIZ s 16384. /512K 

® ® 
SSTKDP s 000000 SCOMEFl <33«48> 000000 <49-64> 000000 

® ® 
SYSTEM NAME = QUASAR $NTUIC» [102,54] 

© ® ® 

LOAD DEVICE = DB0 LBN s 00124461 FILE SIZE = 496, 

SYSTEM FEATURE MASK (FIRST WORD) s 033377 

BIT SET MEANING 

EXT 22-BIT EXTENDED MEMORY SUPPORT 

MUP MULTI-USER PROTECTION SUPPORT 

EXV 20K EXEC SUPPORTED 

DRV LOADABLE DRIVER SUPPORT 

PLA PLAS SUPPORT 

CAL DYNAMIC CHECKPOINT SPACE ALLOCATION 

PKT PREALLOCATION OF I/O PACKETS 

EXP EXTEND TASK DIRECTIVE SUPPORTED 

OFF PARENT/ OFFSPRING TASKING SUPPORTED 

FDT FULL DUPLEX TERMINAL DRIVER 

DYM DYNAMIC MEMORY ALLOCATION SUPPORTED 

CEX COMMUNICATIONS EXEC IS LOADED 



® 

S3YUIC = t2,54] 



SYSTEM FEATURE MASK (SECOND WORD) ■ 167400 
BIT SET MEANING 



DPR 
IRR 
GGF 
RAS 
RBN 
SWP 
STP 



>® 



DIRECTIVE PARTITION SUPPORT 

INSTALL, REQUEST, AND REMOVE TASK SUPPORT 

GROUP GLOBAL EVENT FLAG SUPPORT 

RECEIVE/SEND DATA PACKET SUPPORT 

ROUND ROBIN SCHEDULING SUPPORTED 

EXECUTIVE LEVEL DISK SWAPPING SUPPORTED 

EVENT FLAG MASK IS IN THE TCB 



SYSTEM FEATURE MASK (THIRD WORD) « 025215 
BIT SET MEANING 



CLI 
EIS 
CRA 
STM 
AST 



MULTIPLE CLI SUPPORT 

SYSTEM REQUIRES THE EXTENDED INSTRUCTION SET 
SYSTEM SPONTANEOUSLY CRASHED (1»YES) 
SYSTEM HAS SET SYSTEM TIME DIRECTIVE 
SYSTEM HAS AST SUPPORT 



Figure 3-3 System Common 
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RSX-UM CRASH DUMP ANALYZE" 
SYSTEM COMMON DU M P 



007660 



V4.2 



19-APR-85 15»13 



PACE 4 



16 



007700 



007740 



LABEL 


VALUE 


ADOR 


LABEL 


VALUE 




000760 


010020 


SPOLST 


000403 




010316 




JPRIHL 


003100 




000207 




SPRILL 


001 130 


SHEADR 


1 1 1700 




SPFRSZ 


00031/ 




174000 




SPOLBP 


000063 


SCOMEF 


000000 




SPOLFL 


000200 




000004 




SPOLL" 


0001 44 


SSYSID 


030063 




$parpt 


01 7226 




020105 


010040 


SCLKHD 


04441a 


STKNPT 


107134 




SCOPT 


037356 


SSHFPT 


106704 




SPARHD 


114734 


SCKCNT 


177546 




SLDRPT 


1 12050 


SCKCSR 


177546 




STSKHD 


1 12050 


SCKLDC 


000000 




SXCOM1 


001600 


SSYUIC 


001054 




SXC0M2 


001746 




000000 




SGGEF 




SEXSIZ 


1 15000 


010060 


SGFTCB 


010k'64 


$PWRFL 


000000 




SGEFPT 


010064 


SSIGFL 


000000 




HGEFDM 


000356 


SL06HD 


052254 




SIDLCT 


000000 


SMCRCB 


104360 




SIDLPT 


103741 


SLSTLK 


103640 




SDYPMN 


020035 




000003 






020037 


SCRAVL 


04507*1 






vcvv 5 J 




000000 


010100 




017440 


SACTHD 


112050 






017440 


SDICSV 


001051 






020040 


STKTCB 


1 1205P 




SBTMSK 


000001 


SLBUIC 


000454 






000002 


SABTIM 


007572 






000004 


SRQSCH 


000000 






000010 


SSTKDP 


000000 






n n f% c% T n 
000WC0 


SDEVHD 


063460 


010120 




000040 


SRNOCT 


000005 






000100 


SSWPCT 


000036 






000200 


SERRPT 


00000" 






000400 


SCFLPT 


046444 






001000 




000000 






002000 










00400k) 


SlNTCT 


177777 






010000 


SFRKHD 


000000 


010140 




020000 




010000 






040000 


SFHASK 


033377 






1 00000 




167400 




SERHEA 


000000 




025215 






010146 


SHFMSK 


000003 




SENTSQ 


000001 


JPTfCB 


053510 




SERRS9 


? 


SPRISZ 


00337a 




SERFLA 


^00000 



AODR LABEL VALUE 

010160 000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 

010200 000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 

010220 000000 
SERBAF 051423 
030131 
055472 
026061 
056466 
040502 
045503 

010240 050125 
042456 
051122 
000000 
000000 
000000 
000000 
000000 

010260 000000 
000000 
000000 
SERFID 000000 
000000 
000000 
000000 
000000 

010300 SPRMOO 000000 
SSVSIZ 040000 
000000 
124461 
041 104 
000760 
177777 
000015 



Figure 3-3 (Cont.) System Common 
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3.1.4 System Common Alphabetized Dump 

The listing in Figure 3-4 represents an alphabetical list of the 
locations in system common that have a label associated with them. 
The octal numbers represent the contents of those locations, not the 
addresses of the labels. The following summary lists the labels and 
their meanings. Note that some of these labels may not appear on your 
listing, or that additional labels may appear, depending upon the 
options you selected at system generation. 

$ABTIM Absolute time counter 

$ACCLK Absolute time clock for accounting 

$ACNFE Accounting feature mask word 

$ACTHD Active task listhead 

$ACTPS Clock rate for accounting 

$APLIM Free secondary pool space ACNT reserves 

$AVRHD Automatic volume recognition listhead 

$BTTIM Absolute time when system was booted 

$CBDHD Common block directory listhead 

$CFLPT Checkpoint file PCB listhead 

$CKCNT Address of clock count register 

$CKCSR Clock control status register (CSR) 

$CKLDC Clock load count 

$CKUAB User Account Block (UAB) for task run from clock queue 

$CKURM ONIBUS Run Mask (URM) of processor that keeps the clock 

$CLICQ Command queue listhead 

$CLKHD Clock queue listhead 

$COPT Pointer to Console Output (COO:) Unit Control Block 
(UCB) 

$CPMSK Processor bit clear mask 

$CPPAR Pointer to partition for CPU local memory 

$CPTBL Pointer to Command Line Interpreter Parser Block (CPB) 
Table 

$CRAVL Free system pool listhead 

$CRCSR Crash device CSR address with no Controller Request 
Block (KRB) 

$CRFLG Flag indicating saved registers 

$CRFPR Number of first processor to crash 

$CRKRB Crash dump device KRB address 
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9CKLCK 


One CPU dumps memory 




Crash physical unit number 


$CTLST 


Start of the Controller Table (CTB) list 


9CURPR 


Current task priority 


$CXDBL 


Context switching disabled flag 


9UC1 VHD 


Pointer to first Device Control Block (DCB) 


<^r\ T pott 


Temporary storage for directive services 


<?Vt\i\eK 


APR value to map directive partition 


vUVoAV 


Saved CSR contents for error logging 


s>£<in 1 oy 


Error log entry sequence number 


9bKr LA 


Error Logger flag word 




Error Log message queue listhead 


<^tPD D D rp 


rointer to terror Logger iasK Loncroi biock 




Universal error sequence number 




Buffer sequence number 


tf'p>\Tn t <a 

96 VUiO 


Buffer position for next event 


9CiVKbD 


KioAKo or tset to our rer 


9£j VLbN 


Pointer to word beyond end of buffer 


$EVLOS 


Number of events lost through saturation 


<2jt3< TTC" 

9t, vbj&y 


Event sequence number 




TCB address of event logger task 


9Ci AtRt 


Executive read—only code cyclic redundancy check (CRC) 


9 £4 A Hi L- Li 


oeriaxize access to executive adta aock, 




Executive size 


9FMASK 


System feature mask 


$>FORKL 


Serialize access to fork list lock 


9FRKHD 


Fork queue listhead 


61? VD Dm 
9* AKr 1 


Pointer to parity error task 


9V3Ctr UM 


Group— global dummy mask address word 


Of trtr 


Group— global mask address pointer 


$GFTCB 


Group-global user TCB pointer 


$GGEF 


Group-global event flags listhead 


$GNLST 


General use pool packet listhead 
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$HEADR Pointer to current task header 

$HFMSK Hardware system feature mask 

$HRCPT Pointer to HRC . • • task (privileged task for 
reconfiguration services) 

$ICAVL ICB pool; same as core pool if no data space on system 

$IDLCT Idle pattern count byte 

$IDLFL Idle pattern flag in bytes 

$IDLPT Idle pattern word 

$IICPU Mask of interrupted URMs 

$IIPNL Serialize access to $MPTAB lock 

$IIMSK list interrupt mask word 

$IINXT Round robin word for $IISVC 

$IIPND Pending URM work word 

$INTCT Clock interrupt ticks count 

$LBUIC Library UIC 

$LDPCB Current loader PCB pointer 

$LDRPT Pointer to loader TCB 

$LOGHD Logical device assignment listhead 

$LSTLK Lock word; TCB address of owner 

$MCRPT Pointer to MCR TCB 

$MOULS Mount listhead 

$MXEXT Last address in system common 

$NCPU Number of processors in system 

$NTUIC Network UIC 

$PARHD Pointer to partition list 

$PASTH Partition AST listhead 

$PFRSZ Minimum size of largest fragment in pool 

$PFURM URM to power fail 

$PKAVL Pointer to first preallocated I/O packet 

$PKMAX Maximum number of preallocated I/O packets 

$PKNUM Number of preallocated I/O packets currently in list 

$PLPAR Pointer to secondary pool PCB 

$POLBP Minimum priority for nonpri vileged task to execute at 
low pool 
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$POLFL 


Executive pool usage control flags 


$POLHD 


Listhead for secondary pool free list 


$POLST 


Executive pool communications word 


$PRIFR 


Current amount of free pool 


$PRIHL 


Upper limit for pool monitoring 


$PRILL 


Lower limit for pool monitoring 


$PRISZ 


Minimum size of largest pool fragment 


$PRMOD 


Processor model number 


$PRTAB 


Processor current task priority table 


$PTCBL 


Prototype TCB listhead 


$PTCPT 


KISAR6 bias of prototype TCB 


$PTTCB 


TCB address of pool recovery task 


$PWRFL 


Power-fail recovery request flag 


$PWRLK 


Serialize access to $PWRMK lock 


$PWRMK 


Mask of CPU in power-fail code 


$RNDC 


Clock ticks for each scheduling interval 


$RNDCT 


Number of clock ticks until next scheduled interval 


$RNDH 


Highest priority class to consider 


$RNDL 


Lowest priority class to consider 


$ROEND 


End of read-only part of the Executive 


$RQSCH 


Schedule request TCB address 


$RQTAB 


Reschedule pointer to TCB table 


$SABPT 


Pointer to System Account Block 


$SAHDB 


Bias of current task header 


$SAHPT 


Virtual address of current task header 


$SAVSP 


Saved stack pointer 


$SCCTB 


CTB if $SCDEV contains KRB 


$SCDEV 


UCB or KRB for status change 


$SCERR 


Error return from driver 


$SCMOF 


Offset to data space 


$SCOFL 


On-line or off-line parameter 


$SECFR 


Number of free blocks in secondary pool 


$SGFFR 


Pointer into stack for $SGFIN 



3-12 



ANALYSIS LISTINGS 



$SHBRR Points to TCB of shadow error task 

SSHFCT Minimum ticks between shuffler requests 

$SHFPT Pointer to Shuffler Task Control Block 

$SHFTM Time remaining before next possible request to Shuffler 

$SHLIM Error packet limit 

J?SHLOS Number of packets lost from saturation 

$SHPCT Current shadow error count 

$SHUMB Root for UMB list 

$SIGFL Task waiting for significant event 

$STALR Sanity timer alarm enabled on CPO 

$STENB Sanity timer enabled 

$STKDP Stack depth indicator 

$SWPC Clock ticks for each swapping interval 

$SWPCT Number of clock ticks to next swapping interval 

$SWPR Swapping priority 

$SWR Multiprocessor console switch register 

$SYLHD Listhead for System log input queue 

$SYSIZ Size of memory in 32Kb-word blocks 

$SYUAB Address of UAB for system tasks 

$SYUIC System User Identification Code (UIC) 

$TKNPT Pointer to Task Termination Notification Program (TKTN) 
Task Control Block 

$TKPS Ticks per second 

$TNAME Multiuser task name 

$TSKHD Pointer to System Task Directory (STD) 

$TTNS Tick of second 

$ULDPT Microcode loader task TCB address 

SOMRST Unibus Run Mask (URM) status table 

$VECTR Highest vector address 

$XDTFL Executive Debugging Tool (XDT) initialization table 

$XDTPR Flag for prompts from XDT 
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RSX-11M CRASH DUMP ANALYZER V4.2 



SYSTEM 


COMMON 


ALPHABETIZED 1 


DUMP 


$ ABT I M 


007572 


SERRPT 


000000 


SACTHO 


112050 


SERRSQ 


000000 


SAVRHO 


000000 


SEXSIZ 


1 15000 


SCFLPT 


046444 


JFMASK 


033377 


SCKCNT 


177546 


SFRKHD 


000000 


SCKCSR 


177546 


JGEFDM 


000356 


SCKLDC 


000000 


SGEFPT 


010064 


SCLICO 


000000 


SGFTCB 


010064 


SCLKHD 


044414 


SGGEF 


000000 


SCOPT 


037356 


SHE ADR 


1 1 1700 


SCPTBL 


010472 


SHFMSK 


000003 


SCRAVL 


045074 


SIDLCT 


000 


SCURPR 


370 


JIDLFL 


000 


SCXDBL 


000 


JIDLPT 


103741 


SDEVHD 


063460 


SINTCT 


177777 


SDICSv 


001051 


SLBUIC 


000454 


SDPM 


000040 


SLDRPT 


1 12050 


SENTSQ 


000001 


SLOGHD 


052254 


SERBAF 


023 


SLSTLK 


103640 


JERFID 


000000 


SMCRCB 


104360 


SERFLA 


000 


$MCRPT 


1 10160 


SERHEA 


000000 


JMOULS 


046614 


SERLOF 


000 


SMXEXT 


177777 



19-APR-85 15113 PAGE 6 



SNETPF 


000000 


SSwPCT 


000036 


$NTU IC 


041054 


SSYS IZ 


040000 


$P ARHD 


1 14734 


SSYSNM 


052521 


$p APPT 


017226 


SSYUIC 


00119 54 


SPFRSZ 


000310 


STEMP0 


1 1 01 


SPKAVL 


072230 


STEMP 1 


064170 


SPKMAX 


017 


STEMP2 


13356 


SP K NU M 


012 


STEMP4 


f% e% f% n 1% f% 

000000 


SPOLBP 


000063 


ft T L/ kt O T 

STKNPT 


107134 


SPOLFL 


000200 


STKPS 


r% n t% *9 a 

000074 


SPOLL* 


000144 


JTKTCB 


1 1 2050 


JPOLST 


000403 


STSKHD 


1 12050 


$PR I HL 


003100 


STTNS 


000066 


$P"ILL 


001130 


SUMRHD 


052642 


$PR ISZ 


003370 


SUMRPT 


170200 


JPR MOD 


000000 


JUMRWT 


A n A A A A 

000000 


SPTTCB 


053510 


SWTCSR 


017226 


t n ui fj p i 

JPWRr L 


a f% t% n t% f% 

000000 


SWTDUM 


17226 


SRNDCT 


000005 


SXC0M1 


001600 


SRQSCH 


000000 


SXCOM2 


001746 


SSHFPT 


106704 






SSIGFL 


000000 






SSTKDP 


000000 







Figure 3-4 System Common Alphabetized Dump 
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3.1.5 Pool Statistics 

The listing in Figure 3-5 contains information concerning the system 
pool. CDA derives Items 2, 3 f and 4 by scanning the free block 
pointers of the pool. The minimum block size (that is, pool 
granularity) in Item 5 comes from the contents of $CRAVL-2. Each item 
in the following list describes a correspondingly numbered item in 
Figure 3-5. 

Item Description 

1. Pool size in decimal bytes 

2. The largest fragment of pool space 

3. Total number of free bytes in pool 

4. Number of fragments not allocated 

5. Smallest possible block (This is the minimum number of 
bytes which may be requested at a time. The minimum 
block size is always four bytes.) 

6. Bit map in octal 

Each bit in the bit map represents one 4-byte block. If the bit is 
set, the block is free. The first block in the pool is bit of the 
first octal word in the bit map. The bits are numbered as follows: 

Bit Number 15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 

Binary Oil 101 111 111 000 

Octal 3 5 7 7 

Any bits left over in the last word of the bit map are cleared. 
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R8X-11M CRASH DUMP ANALYZER 
POOL STATISTICS 



V4.2 



19-APR-85 



10150 



PAGE S 



ROOL SIZE (BYTES) s 16532. © 

LARGEST FREE BLOCK (BYTES) s 12al6.© 

TOTAL FREE BYTES c 12676.© 

NUMBER OF FRAGMENTS « 10.® 

MINIMUM BLOCK SIZE (BYTES) = 4,© 

POOL BITMAP (CONSTRUCTED FROM LINKED POOL, BLOCK FREE IF BIT SET) I 



000000 


100434 


000000 


007000 


000040 


140000 


002001 


000000 


00000k) 


000000 


000000 


000000 


000004 


000000 


000000 


000000 


176000 






017777 


000000 


000000 


177740 






177777 


177777 


177777 








177777 


1 77777 


177777 


1 77777 


177777 


177777 


1 77777 


177777 


177777 


177777 


1 77777 


177777 


177777 


177777 


177777 


177777 


177777 


1 77777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


177777 


1 77777 


177777 


1 77777 


177777 


177777 


177777 


177777 


177777 


177777 


1 77777 


177777 


1 77777 


177777 


177777 


177777 


1 77777 


177777 


177777 








177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 
















177777 










000037 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 













Figure 3-5 Pool Statistics 
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3.1.6 Assign Table 

Figure; 3-6 is a listing of the logical device assignment table. 

RSX-UM-PLUS CRASH DUMP ANALYZER V3.0 16-APR-85 09: 15 
ASSIGN TABLE 

System Logicals: 
SY * DR5; 

Block; 1 Status! (Final) 

EDTINI s SYS$LOGIN:EDTINI 
Block: l 



User Logicals; 

Terminal; TT5: 

SYSSLOGIN a DR5: (COVERT) 

Block: 2 Status: (Final, Privileged) 

Terminal: TT24: 
IN a DR5: 

Block: 1 Status: (Final) 

SYSSLOGIN a DR5: [007 , 325J 

Block: 2 Status; (Final, Privileged) 

Terminal; TT75: 

HOME a DR5: (7, 40) 
Block: 1 

DEFCOR a 0B3 : Cbl,401 

Block: l 

DUMPS = LB:[4,54) 
Block: 1 

SYSSLOGIN a DR5 : 17,40] 

Block: 2 Status: (Final, Privileged) 



Figure 3-6 Logical Assignment Table 



The Assign Table lists logical assignment table entries in two 
categories: system logicals and user logicals. The system logicals 
listing shows the logical name, the equivalence name, the number of 
blocks, and the status of an assignment. The user logicals listing 
also shows the terminal from which an assignment was made. 
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3.1.7 Group-Global Event Flags 

Figure 3-7 shows a group-global event flag dump. If there are no 
group-global event flags, this dump does not appear. 

Item Description 

1. Group number 

2. Access count 

3. Group-global Event Flag Block dump 

(The last two words are the group-global event flags.) 

RSX-HM-PLUS CRASH DUMP ANALYZER V4.2 19-APR-85 10117 PAGE 18 

GROUP GLOBAL EVENT FLAGS 



© © 

GROUP NUMBER si ACCESS COUNT =177476 
GGEF DUKPi 

0000OP! PI56660 000401 177476 000015 000000 

GROUP NUMBER =7 ACCESS COUNT =006332 
GGEF DUNPl 

00C*tf£ , i* 070000 H00007 006332 000014 41000015 

Figure 3-7 Group-global Event Flags 



3-18 



ANALYSIS LISTINGS 



3.1.8 Error Log Packets 

The listing shown in Figure 3-8 contains error logging information 
that resided in memory at the time of the crash. This page does not 
appear if no error log packets were in memory at the time of the 
crash. This data is not written to the Error Log file on disk. 



Item 


Description 




1. 


Address of error log buffer 




2. 


Error log packet entry type 


code 


3. 


Error log packet entry type 


subcode 


4. 


Time the packet was logged 




5. 


Dump of error log packet in 


octal 



RSX-HM CRASH DUMP AMALYZER V4.2 19-APR-85 13:58 PAGE 8 
ERROP LOG BUFFERS 

© © ® 

BUFFER ADDRESS s 072304 ENTRY TYPE CODE = (300002 ENTRY TYPE SUBCODE ■ 000001 



TIME * 


7-JUL-81 


07|«fe:n 




© 










000000 


000000 


00021 


00003a 


000055 


000401 


030463 


020040 


003401 


000020 


000025 


00001 3 


000402 


003521 


003407 


005456 


000106 


00000 1 


00004(4 


£00046 


046504 


PI00001 


000001 


000000 


047115 


052105 


031526 


000060 


C141 1 1 7 


0001 12 


000000 


000000 


000000 


000001 


064766 


000000 


000100 


011532 


000000 


000000 


002030 


045662 


131574 


000424 


047503 


000120 


000400 


001 000 


00^003 


03001 7 


004010 


177000 


000000 


000056 


000140 


101223 


1 727a 1 


044702 


000424 


004301 


1 00301 


000000 


000000 


000160 


000253 


177777 


033065 


022000 


004066 


000000 


010341 


100000 


000200 


101721 


000001 


000001 


105262 


0301 1 1 









© 



Figure 3-8 Error Log Packets 
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3.1.9 Low Core Memory Dump (RSX-11M-PL0S Only) 

The listing shown in Figure 3-9 contains a dump 
core memory, alphabetized by label. 



of RSX-11M-PLUS low 



The following summary lists labels 
memory and their meanings: 



found in RSX-11M-PLUS low core 



$CRSBF Internal crash stack 

$CRUPC Scratch user program counter (PC) 

$CROST Scratch user Processor Status Word (PSW) 

$CURPR Pointer to current task priority 

$CXDBL Context switch disable flag 

$DICSV Temporary storage for directive service 

$DXDEP Entry point to dynamic Executive debugger interface 

$DXDK5 Saved KINAR5 for dynamic Executive debugger interface 

$DXDRL Relocation bias for dynamic Executive debugger 
interface 

$HEADR Pointer to current task header 

$PARLV Interrupt recursion level counter 

$RQSCH Pointer to current reschedule pointer 

$SAHDB Bias of current task header 

$SAHPT Virtual address of current task header 

$SAVSP Saved stack pointer 

$SIRWF Supervisor instruction space read/write flag 

$STKDP Stack depth indicator 

$SUPFL Supervisor window flag 

$TKTCB Pointer to current task TCB 



R8X»1 i M *P|»US CRASH DUMP ANALYZER V3,0 
LOWCORE ALPHABETIZED DUMP 



19-APH-85 15144 



PAGE 3 



SCRSBF 




000000 




000000 


SRQSCH 


021712 




000009 


000000 




000000 


SSAHDB 


000000 




000000 


000000 




000000 


SSAHPT 


000000 




000000 


000000 




000000 


SSAVSP 


000000 


SCRUPC 


000000 


000000 


$D*DEP 


000000 


SSIRMF 


000 


SCRUST 


000000 


000000 


SDXDK5 


000000 


S8TKDP 


000000 


SCURPR 


021722 


000000 


SDXD»L 


000000 


S3UPFL 


000 


SCXDBL 


000 


000000 


*HEADR 


000000 


STKTC8 


000000 


SDICSV 


000000 


000000 


SPARLV 


177777 







Figure 3-9 Low Core Memory 
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3.2 OPTIONAL INFORMATION 

CDA gives you additional information when you use the analysis 
switches described in Chapter 2. Figures 3-10 through 3-24 illustrate 
the output that CDA provides when you use these switches. 

3.2.1 Active Tasks 

The listing shown in Figure 3-10 contains active task information. 
The Receive Queue, AST Queue, Recei ve-by-Ref erence Queue, and 
Offspring Control Block sections of this example appear only if the 
task has them; otherwise, they are suppressed. Section 3.2.2 
describes the additional information in the active task listing when 
the active task is MCR. 

Item Description 

1. Task name 

2. Address of Task Control Block (TCB) for the task 

3. Name of the partition in which the task runs 

4. Address of Partition Control Block (PCB) 

5. Base address for the partition in which the task runs 

6. Device that contains task image 

7. Beginning logical block number (LBN) of the task on the 
device 

8. Running priority 

9. Number of outstanding QIO requests 

10. Current UIC (either the login UIC or the UIC specified 
with a SET command) 

11. Physical name of task's pseudo device 

12. Maximum size of task image in 32 (decimal) -word blocks 

13. State of local event flags for task 

14. First status word (blocking bits) , using the following 
three-letter codes: 



-EXE 


- Task not executing 




RDN 


- I/O rundown in progress 




CIP 


- Task blocked for checkpoint 


in progress 


MSG 


- Abort message being output 




CKR 


- Task has checkpoint request 


(RSX-11M-PLUS 


BLC 


- Increment blocking count 




STP 


- Task stopped by CLI command 
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Item Description 

15. Second status word (state bits) , using the following 
three-letter codes: 



AST 


- Asynchronous system trap (AST) in progress 


SIO 


- Task stopped for buffered I/O 


DST 


- AST recognition disabled 


AFF 


- Task installed with affinity 


-CHK 


- Task not checkpointable 


SEF 


- Stopped for event flag 


REX 


- Exit AST specified 


HLT 


- Task being halted 


ABO 


- Task marked for abort 


STP 


- Task stopped 


SPN 


- Task suspended 


WFR 


- Task in wait-for state 



16. Third status word (attribute bits) , using the following 
three-letter codes: 



ACP 




Task 


is an Ancillary Control Processor (ACP) 


PMD 




Task 


not dumped on synchronous abort 


CMD 




Task 


is executing a CLI command 


REM 




Remove task on exit 


PRV 




Task 


is privileged 


MCR 




Task 


requested as an external MCR function 


SLV 




Task 


is a slave task 


CLI 




Task 


is a command line interpreter 


RST 




Task 


is restricted 


NSD 




Task 


does not allow send data 


CAL 




Task 


has checkpoint space in task image 


ROV 




Task 


has resident overlays 


NET 




Network protocol level 


GFL 




Group 


'-global event flags are locked 


SWS 




Reserved for Software Services 


MPC 




Mapping change with outstanding I/O 
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Item Description 

17. Fourth status word, using the following three-letter 
codes : 

MUT - Task is a multiuser task 

LDD - Task load device is dismounted 

PRO - TCB is a prototype 

PRV - Task was privileged but has cleared TB.PRV with 
the GIN directive 

DSP - Task was built for user data space 

SNC - Task uses common synchronization 

18. Octal dump of TCB in offset mode 

RECEIVE QUEUE (if the task has one) 

19. Starting address of receive block 

20. Name of task 

21. Octal dump of receive block in offset mode 

OFFSPRING CONTROL BLOCK (OCB) LIST (if the task has one) 

22. Exit event flag number of offspring task 

23. Name of parent task 

24. Octal dump of offspring control block in offset mode 

ASYNCHRONOUS SYSTEM TRAP (AST) QUEUE (if the task has one) 

If a task has an AST Queue, CDA lists its contents. If the task also 
has a Receive Queue, the AST Queue appears immediately after the 
Receive Queue on the output listing. If the task does not have a 
Receive Queue, the AST Queue is listed after the fourth status word 
information (the example in Figure 3-10 does not include an AST 
Queue) . 

An item appearing in the AST queue may be one of the following: 

• Unsolicited AST 

• Floating point AST 

• Receive data AST 

• Recei ve-by-ref erence AST 

• Parity error AST 

• Requested exit AST 

• Power fail 

• CLI command arrival AST 

• Buffered I/O AST 
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• Offspring task AST 

• Segmented buffered I/O completion AST 

• Task force trace bit trap AST 

• Delayed I/O completion AST 

• Group-global rundown AST 

• I/O request packet 

- Address of AST block 

- A 2-byte indicator (The high-order byte is an offset into 
the header of the AST control block; the low-order byte is 
the length of the AST control block in bytes.) 

NOTE 

If the low-order byte is negative, the block is not 
an AST block, but an I/O request packet internal to 
the system. If the low-order byte is 0, the block 
is an unsolicited character AST. 



Number of bytes allocated on task stack 

Entry point of AST routine 

Number of AST parameters 

- Octal dump of the AST block in offset mode (On RSX-llM-PLUS 
systems, two additional negative offset words appear in the 
dump. ) 



RECEIVE -BY-REFERENCE QUEUE (if the task has one) 

If a task has a Recei ve-by-Ref erence Queue, CDA lists its contents. 
If the task also has an Offspring Control Block list, the 
Recei ve-by-Ref erence Queue appears immediately before the OCB list on 
the output listing. If the task does not have an OCB list, the 
Recei ve-by-Ref erence Queue is the last list on the Active Tasks 
listing (the example in Figure 3-10 does not include a 
Recei ve-by-Ref erence Queue) . 

Address of Recei ve-by-Ref erence Queue Block 

Address of the Task Control Block (TCB) for the task that 
initiated the Send by Reference 

Contents of event flag mask 

Address of event flag mask 

Pointer to created attachment descriptor 

Offset into partition as specified in window definition 

Length to be mapped 

The receiving task's access rights to region being mapped 
Octal dump of Recei ve-by-Ref erence Block in offset mode 
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RSX-MM-PLUS CRASH DUMP ANALYZER V3.0 
ACTIVE TASKS 



19-APR-85 13102 



PAGE 13 



iLDR 



® 

PAR > SYSPAR. 



© 



PCB ADDRESS > 111434 

® 

LBN s 00076636 

® 
TI ■ CO0I 



TCB ADDRESS ■ 111650 

© ■(•) 
LOAD ADDRESS ■ 00461600 LOAD DEVICE » L&0I 

© © ® 

PPI • 2«6. I/O COUNT ■ 0. UIC ■ [1*24] 

© © 
MAX SIZE » 000035 EVENT FLAGS • <1-16> 000001 <17-32> 000000 

T.STATl 000000 © 

T.ST2I 020020 -CHK STP @ 

050200 -PMD PRV NSD @ 

000000 (17) 



T.8T3I 
T.ST4I 
TCB DUMPi 



000000 000000 000370 000000 131574 045662 000000 111662 000000 

000020 111666 000001 000000 022370 111300 000000 020020 050200 

000040 000370 076636 031420 111434 000035 033500 111426 111426 © 

000060 000000 000000 000000 000001 111672 000035 000000 000000 

000100 000000 111750 000000 111754 000000 000000 000000 000000 



RECEIVE QUEUE 



19 



20 



RECEIVE BLOCK ADDRESS • 062000 TASK NAHE ■ TUSKRD 

000000 000000 100143 043624 06264? 050210 016000 121502 024172 

000020 140902 133406 000000 000000 000000 000000 000000 000000 
000040 046522 000000 
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OCB LISTl 



EXIT EVENT FLAG (O.EFN) • 000000 (22) 
PARENT TASK NAME s QmG.,, (g) 
OCB DUMP 1 



000000 
000020 



000000 
000000 



000000 
000000 



1P6U24 
000000 



12135* 

000009 



000000 
0000100 



000000 
00000? 



0661 17 131574 (24) 



Figure 3-10 Active Tasks (Truncated) 
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3.2.2 Active Task (MCR) 

The active task listing for the MCR task (MCR...) contains more 
information than the active task listing for other tasks. Figure 3-11 
shows a listing in which the first 17 items are the same as those in 
Figure 3-10. The following list describes only the items that are 
different from those in the previous figure, when MCR... is the 
active task. 

Item Description 

1. Address of MCR input buffer 

2. Address of Unit Control Block (UCB) of the requesting 
terminal 

3. Device name and unit number of the terminal that sent 
block to MCR (ASCII characters) 

4. Octal dump of the MCR input buffer in offset mode 

5. Address of command buffer 

6. Address of Task Control Block of the requesting task 

7. ASCII dump of command buffer 

8. Octal dump of command buffer in offset mode 
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rsx-11m-plus crash dump analyzer 
active: tasks 



V3.c? 



19-APR-85 16:23 



PAGE 10 



MCR • • • 



TCB ADDRESS * 114610 PAR s SYSPAR 

LOAD ADDRESS s 00174400 LOAD DEVICE = LB0 

PRI ■ 160. I/O COUNT s 0, UIC = [1,24] 

MAX SIZE ■ 000100 EVENT FLAGS s <1-16> 000001 



PCB ADDRESS s 037050 

LBN i 00073747 
TI * TT3 
< 1 7- 32> 040000 



T.STATl 

T.ST2I 

T.ST3I 

TCB DUMP 

000000 
000020 

000040 
000060 
000100 



000000 
000020 STP 
051300 -PMD PRV 



000000 000240 

114626 000001 

000240 073747 

003000 000000 

004256 



CLI NSD CAL 



000000 
040000 
035636 

000000 



050712 
024552 
037050 
1 14674 



131574 
1137t0 
000100 
000000 



000000 
000000 
112330 
1 14700 



114622 
000020 
036046 
000000 



000000 
051300 
036046 
000000 



RECEIVE QUEUE 



© © 
COMMAND LINE INPUT BUFFER ADDRESS s 036730 UCB * 030245 

TT50 | 



000000 043214 030245 03577? 

000020 120430 001750 140030 

000040 000040 300000 

000060 026226 000000 

000100 000000 113234 



000050 000020 
000000 001751 



000000 000000 

00000e 117404 



000000 

005627 000362 



000010 037050 000000 



000000 
140010 

000000 000000 



000000 
036120 036120 



030244 000400 
000027 000361 
000214 
000362 
000000 



MCR COMMAND BLOCKS 



© 

BUFFER ADDRESS s 103100 
ASS DB01*sSY:/LOGIN 



000000 

000020 
00004C? 
00006? 
000 100 
000120 



000000 

?27472 
024600 

000000 

17PV00 

000000 



102730 
047514 
000420 
060440 
1261*2 

0000/0 



© 

TCB s 102730 



051501 020116 041104 030460 036472 054523 

044507 015516 026226 000000 000000 117404 

000000 000420 000000 103020 000010 104074 

06044^ 060370 103370 000114 000612 033406 

000000 000000 0/0000 000000 000012 000137 



Figure 3-11 Active Task (MCR) 



3-27 



ANALYSIS LISTINGS 



3.2.3 Task Headers 

Figure 3-12 is an example of a task header listing. The following 
list describes its contents. 

Item Description 

1. Task name 

2. Pointer to the first word in the task header 

3. Pointer to the first word in the Task Control Block (TCB) 

4. Contents of Processor Status Word (PSW) and Program 
Counter (PC) 

5. Contents of the general registers 

6. Initial contents of the PSW, the PC, and the stack 
pointer (SP) 

7. The task header size in decimal bytes, the number of 
windows required to map the task, and the number of 
logical unit numbers assigned to the task 

8. Current and default UIC 

9. Pointer to number of window blocks 

10. Pointer to header guard word 

11. Work area extension vector pointer 

12. Priority difference for swapping 

13. Directive Status Word 

14. Address of File Control Services (FCS) impure area 

15. Address of FORTRAN impure area 

16. Address of overlay impure storage 

LOGICAL UNIT TABLE 

17. Logical unit number (LUN) 

18. Physical device name before redirect 

19. Window pointer in header 
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Item Description 

20. Low-order byte of this word indicates the number of map 
entries active; the high-order byte has the following bit 
assignments : 

WI.RDV=400 - read virtual address allowed if set 
WI.WRV=1000 - write virtual block allowed if set 
WI.EXT=2000 - extend allowed if set 
WI.LCK=4000 - set if locked against shared access 
WI.DLK=10000 - set if deaccess lock enabled 
WI .BPS=100000 - bypass access interlock if set 

21. Address of File Control Block 

22. File number 

23. File sequence number 

24. File Control Block status word 

25. Number of accesses 

26. Number of block locks 

WINDOW BLOCKS 

27. The name of the partition in which the task runs 

28. The virtual limits of the task 

29. Address of attachment descriptor 

30. Window size in 32-word blocks 

31. Offset into partition 

32. Address of the first Page Description Register (PDR) used 
to map the window 

33. Number of PDRs used 

34. The contents of the last PDR used 

35. Octal dump of task header in offset mode 
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RSX-11M CRASH DUMP ANALYZER V4.2 19-APR-85 1 5 1 1 3 PAGE 37 

TASK HEADERS 

TKTN 

HEADER ADDRESS « 076060 TCB ADDRESS = 107134 

PS«170000 PC«122630 @ 

R0>120254 R1S000065 R2«000060 R3«140354 R4*120702 R5«051024 SPM20226 5 
INITIAL PS ■ 170017 INITIAL PC * 120764 INITIAL SP a 120230® 
HEADER SIZE * 102. NO. OF WINDOWS » 1. NO. OF LUNS * 1,® 

CURRENT UIC » [1,24] DEFAULT UIC s tl»24](?) 

® ® ® @ 

H.WND s 076162 H.GARD ^076224 H.VEXl^s 000000 H.SPRI = 5. 

@ @ ® ® 

DSW x 000001 H.FCS s 000000 H, FORT « 000000 H.OVLY = 000000 



LOGICAL UNIT TABLE I 

@@@ ® @ @ ® @@(g) 

« DEV WINDOW W.CTL W.FCB F.FNUM F.FSEQ F.STAT NAC NLCK 

1 T 1 1 000000 



WINDOW BLOCKSi 

@ @ @ (§) @ @ @ @ 

PAR VIRT LIMITS ATT DESC WND SIZE OFFSET 1ST PDR NO. LAST PDR 

TKNPAR 120000 127777 045220 000100 000000 177612 1 037406 



HEADER | 



000000 

000020 
000040 
000060 
000100 

000120 
0001*10 



120226 
120230 

000000 

000005 

000900 

000612 
000065 



000146 
000000 
000000 

000000 

000001 
037406 
120254 



140354 
000000 
076162 

000000 

114«50 
170000 

000000 



163500 
000000 
000001 
000000 
120000 

122630 



000424 
000000 
000000 

000000 

127777 
051024 



000424 
000000 
000000 

076224 



170017 120764 
000000 000000 



000000 
000001 



045220 000100 
120702 140354 



000000 
044570 
000000 
000060 



35 



Figure 3-12 Task Headers (Truncated) 
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3.2.4 Command Line Interpreter Parser Block (CPB) 

The listing shown in Figure 3-13 contains the Command Line Interpreter 
Parser Block for MCR. The listing corresponds to the following items: 

Item Description 

1. Task name of the CLI 

2. Starting address of the CPB 

3. C.PSTS, which is the CPB status word 

4. Dump of the CPB in octal 

RSX-HM CRASH DUMP ANALYZER V4.2 19-APR-85 15:13 PAGE 9 

CLI PARSER BLOCKS 

CLI TASK NAME MCR, . . ® 

CPB ADDRESS e 010472 CLI NAME = MCR© 
C.PSTS! SGL (f) 

CPB DUMP: 

000000 110160 050712 000000 700040 003a04 tf05015 000076 005015 ® 
000020 041515 037122 000000 

Figure 3-13 CLI Parser Blocks 



3.2.5 Partition Information 

CDA outputs partition information in two segments. The listing shown 
in Figure 3-14 contains system partition information, and the listing 
shown in Figure 3-15 represents individual partition information. The 
following list describes elements of Figure 3-14. Individual 
partitions include Attachment Descriptors and Wait Queues when they 
apply. 

Item Description 

1. Partition names 

2. Partition Control Block (PCB) address 

3. Base address of partition in memory 

4. Size of the partition 

5. Type of partition 

6. Task or tasks occupying the partition 
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RSX-UM CRASH DUMP ANALYZER V4.2 19-APR-85 15113 PAGE 5a 

PARTITION INFORMATION 



MEMORY MAP 



(!) 


(?) 


(2) 


(!) 


© 


(!) 


'ARTITION 

> mmmm •••• 


PCB ADR 
------- 


BASE 
- - - - 


SIZE 
---- 


TYPE 


OCCUPIED 






0000R000 

%j %j yj XJ t.i v c 


0H0UU700 












f C *C» *# M f H' t' 


t l' J H 1 C wJ 








CEXP AR 


1 1 IXTKli 

i 4 1 J H 


00115000 


00003000 


MAIN 


COMMON 




TTP AR 


\ 14670 


00120000 


00040000 


MA IN 


DRIVER 


TT I 


EXCOM 1 




00160000 


00014600 


MAIN 


COMMON 




EXC0M2 


1 1 4 5fcfl 


00174600 


00006100 


MAIN 


COMMON 




S YSP AR 


1 1 45 1 4 


002027^0 


00010000 


MAIN 


TASK 


MCR ... 


TKNPAR 


l 14450 


00212700 


000 1 0000 


MAIN 


TASK 


TKTN 


DRVPAR 


l 14404 


00222700 


00030200 


MAIN 


SYS 






l 14340 


00222700 


00002100 


SUB 


DRIVER 


DBj 




1 14240 


00225300 


00001 200 


SUB 


DRIVER 


DK| 




114140 


00226200 


000030fla 


SUB 


DRIVER 


DM J 




1 14040 


00231200 


00003000 


SUB 


DRIVER 


ORl 




1 13740 


00234200 


00001000 


SUB 


DRIVER 


E M | 






00235200 


000001M0 


<H0LE> 






1 1 3640 


00235300 


0000 1 1 00 


SUB 


DRIVER 


DT | 




1 1 3540 


00236400 


00001400 


SUB 


DRIVER 


DX I 




113440 


00240000 


00002200 


SUB 


DRIVER 


DL : 




113340 


002a2200 


00002600 


SUB 


DRIVER 


DDI 




1 1 3240 


00245000 


0000 1300 


SUB 


DRIVER 


LPl 




1 13104 


00246300 


00004300 


SUB 


DRIVER 


MM J 




112450 


00252600 


00PI00300 


SUB 


DRIVER 


COi 


LDRPAR 


11240a 


00253100 


00002500 


MAIN 


TASK 


LOR. . . 


BASIC2 


1 12340 


00255600 


00040000 


MAIN 


COMMON 




FCSRES 


1 12274 


00315600 


00040000 


MAIN 


COMMON 




TSTPAR 


1 12230 


00355600 


00100000 


MA IN 


TASK 




GEN 


1 12164 


00455600 


03322200 


MAIN 


SYS 






045620 


00455600 


00024000 


SUB 


TASK 


DS2FCP 




057144 


00501600 


00025500 


SUB 


TASK 


NETACP 






03527300 


A0005200 


<H0LE> 






064060 


00534500 


00023300 


SUB 


TASK 


RMHACP 




053004 


00560000 


007105200 


SUB 


TASK- 


CA.T6 




073534 


00565200 


30005200 


SUB 


TASK 


CA.T30 






00572400 


00005700 


<HOLE> 






0450 1 


00600300 


00005700 


SUB 


T ftSK 


PMT... 



Figure 3-14 Partition Information 
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Each item in the following list describes a correspondingly numbered 
item in Figure 3-15. 

Item Description 

PARTITION CONTROL BLOCK 

1. Partition name 

2. Pointer to the first word of the PCB 

3. Type of partition 

4. Name of main partition. 

5. Physical base address of partition in 32-word blocks 

6. Partition size in 32-word blocks 

7. Pointer to the first word of the TCB of attached task 

8. Partition protection word (mapped system only) 

9. Priority of attached task or partition 

10. I/O count of attached task or partition 

11. Partition status flags, using the following three-letter 



codes : 






OUT 


- Partition 


is out of memory 


CKP 


- Partition 


checkpoint in progress 


CKR 


- Partition 


checkpoint is requested 


CAF 


- Checkpoint 


space allocation failure 


-CHK 


- Partition 


is not checkpointable 


FXD 


- Partition 


is fixed 


LFR 


- Last head 


of region failure 


PER 


- Parity error in partition 


LIO 


- Marked by 


Shuffler for long I/O 


NSF 


- Partition 


cannot be shuffled 


COM 


- Library or 


common block 


DEL 


- Partition 


should be deleted when not attached 



12. Octal dump of PCB in offset mode 
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Item Description 

ATTACHMENT DESCRIPTOR 

13. Address of attachment descriptor 

14. Partition to which attachment occurs 

15. Name of attaching task 

16. PCB attachment queue thread word 

17. TCB attachment queue thread word 

18. Priority of highest priority task attached to this 
partition 

19. I/O count of attached task on RSX-llM systems; I/O count 
of attached partition on RSX-llM-PLUS systems 

20. Number of times task is mapped through this attachment 
descriptor 

21. Attachment descriptor status byte, using the following 
three-letter codes: 

DEL - Task has delete access 

EXT - Task has extend access 

WRT - Task has write access 

RED - Task has read access 

PRO - TCB is secondary pool TCB bias 

SPB - Cache bypass request 

RBP - Request to not bypass cache 

22. Octal dump of attachment descriptors in offset mode 

PARTITION WAIT QUEUE 

23. Name of the task awaiting access to the partition 

24. Address of TCB for the task 

25. TI: device for the task 

26. Task's priority 

27. Second status word (state bits) — same as item 15 of the 
active task dump (Section 3.2.1) 

RSX-llM-PLUS SYSTEMS ONLY ADDITIONAL ITEM DESCRIPTION 

28. Resident mapped task count 

29. Wait queue contains partition description rather than 
task description 
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PARTITION PCB ADR TypE MAIN BASE SUE P.TCB PRO PRI IOC 

OR VP AR 117270 SUB ORVPAR 51 Pt 1 3 1 2 000k?60 040754 000000 0, 0. 
P,STAT| SYS DRV 

0?eS00 000003 000000 1 5 7 a 6 062^72 000000 117734 001312 000060 

tf0e*020 1100000 000000 000000 040754 000060 00000? 000000 000000 

000040 117326 



05 © © © © ® © 

PARTITION PCB ADR TYPE MAIN BASE Sl^E P.TCB 



© © ® 

PRO PRI IOC 



SYSPAR 1)7^74 MAIN SYSPAR 001372 000105 115264 000000 0, 0. 
P.STAT | @ 

00fl£lfc>0 117030 000000 075273 062072 000000 1 17074 001372 000105 
000020 115764 115764 100200 115264 000000 042760 000000 042000 
00GH40 041764 



WAIT UUEUEt 

@ © 
TASK TCB ADR 



FllACP 115764 



TI T.PRI 
CO0 149. 



© 

STATE BITS (T.ST2) 
CAF STP 



ATTACHMENT DESCRIPTORS: 



(14 



© 



(16) 



© © © 



042000 SYSPAR ,.,MCR 

A , ST AT J NPT RED © 



041764 000000 160, 0. 



® 



ADDRESS PARTITION ATT TASK A.PCBL A.TCBL PRI IOC MAP COUNT 



0. 



0001400 041764 000240 1 15264 000000 000003 1 17074 © 



Figure 3-15 Partition Control Blocks 
and Attachment Descriptors 
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R3X-UM»Pi.U8 CRASH DUMP ANALYZER V3,(S ?»*AY»85 15*36 PAGE 83 

PARTITION INFORMATION 

@ 

NAME PCB AOR TYPE MAIN BASE SIZE P. OWN PRO PRI RMCT 

GEN 1 1 7af a main gen 004432 ei473«6 000000 000000 0, 0, 

Pi STAT t 000000 
P,ST2l 000000 

000000 000000 000*01* 026236 000000 55724 117404 004432 047346 
000026; 061774 063170 000000 000000 000000 000000 000000 000000 
00004P P00*00 



WAIT QUEUE I © 



NAME PCB AOR TYPE MAIN BASE SIZE P.TCB PRO PRI RMCT 

trnmrnmrnmrnw > ' ' m»<mm mmmm »■»:<■■» mmm mmm 

BAP2 061774 SUB GEN f'12731 000372 061670 00000? 50. 0, 

P.STATl 140011? OUT CKP DEL 

00000/ 063170 000062 026226 300000 063170 117404 012731 000372 

000020 P00000 000372 074114 ?6t67e 1U0010 462474 000000 037360 
00004P 037360 



Figure 3-15 {Cont.) Partition Control Blocks 
and Attachment Descriptors 



3.2.6 Common Block Directory 

CDA lists partition information, status words, and Partition Control 
Blocks for each installed, named common region. The listing in Figure 
3-16 shows a Common Block Directory entry. The following list 
describes the items in Figure 3-16. 

Item Description 

1. Name of the installed common region partition 

2. Address of Partition Control Block (PCB) 

3. Type of partition 

4. Name of the main partition 

5. Physical base address of partition 

6. Size of partition in 32 (decimal) -word blocks 

7. Owning UIC of the common region 

8. Partition protection word 
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Item Description 

9. Resident mapped task count 

10. Partition status words (refer to Section 3.2.4) 

11. Octal dump of PCB 

12. Address of PCB of the common task image file 

13. Address of Unit Control Block (UCB) of the device on 
which the common resides 

14. Starting logical block number (LBN) of the common task 
image file 

15. Word that always contains a 

RSX-i IM-PLUS CRASH DUMP ANALYZER V3.# 2-MY-85 14103 PAGE 75 

COMMON BLOCK DIRECTORY 

© ©©©©©0® © 

NAME PCB ADR TYPE MAIN BASE SIZE P. OWN PRO PRI RMCT 



GEN 017747 200400 001454 000000 0, 0, 




00000K 0U0PP0 000000 006273 034330 040370 117404 017747 000400 
000020 053550 000000 PI4524P 001454 000200 000006 000000 000000 )>- (ij) 
w c a fr» 1^43312 



COMMON TASK IMAGE FILE PCB _ ^ 
© @ © © 

PCB ADR P.UCB P. LBN P.REL 



k'45240 ^35662 ^0*00 1 , 023653 00000C; 

NAME PCB AD* TYPE "AlN BASE SIZE P. OWN PRO PRI RMCT 

FCSSUP 05355H SUB GEN M$mv 000212 000401 000000 0, 0. 

P.STATj 10020/ OUT CHM 

P.ST2| 00000:4 

000HP0 000000 000400 023013 075030 000000 11740a 000000 000212 
0001420 047304 000212 0401 14 000401 100200 000000 000000 000000 
0000U0 U53606 

COMMON TASK IMAGE FILE PCB 

PCB ADR P.UCB P. LBN P.REL 

040114 035662 U00002, 001071 000000 

Figure 3-16 Common Block Directory 
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3.2.7 Device Information 

CDA lists information on all devices known to the system. The listing 
in Figure 3-17 shows a typical terminal device listing with an I/O 
packet. The Terminal Status Words (items 15, 16, and 17) appear only 
in listings for terminal devices. The codes for these items apply 
only to the full-duplex terminal driver. The section labeled I/O 
REQUEST PACKETS appears only for devices that have an I/O request in 
progress or an I/O request queued at the time of the system crash. 
The following list describes the items in Figure 3-17. 

Item Description 

1. Device name 

2. Address of offset in Unit Control Block (UCB) 

3. Address of offset in Device Control Block (DCB) 

4. Address of offset in Status Control Block (SCB) 

5. Device to which unit is redirected 

6. Name of Ancillary Control Processor (ACP) 

7. Name of attached task 

8. Pointer to the UCB name of the owning terminal 

9. UIC used to log into the system 

10. Unit status byte, using the following three-letter codes: 

BSY - Unit is busy 
-MNT - Unit is not mounted 
FOR - Unit is mounted as a foreign volume 
MDM - Unit is marked for dismount 
PWF - Power fail occurred 
WCK - Write check enabled 
SPU - Unit is spinning up 
W - Volume is valid 

11. Unit status extension byte, using the following 
three-letter codes: 

OFL - Unit off line 

-RED - Unit is not redirectable 

PUB - Unit is public device 

UMD - Unit attached for diagnostics 

PDF - Privileged diagnostic functions only 
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Item Description 

12. Control Processing flags, using the following 
three-letter codes: 

-ALG - Byte alignment not allowed 

NPR - Device is a NPR device 

QUE - Call driver before queuing 

PWF - Always call driver at power fail entry point 

ATT - Call driver on attach/detach 

KIL - Always call driver at I/O kill 

13. First device characteristics word, using the following 
three-letter codes: 

REC - Record-oriented device 

CCL - Carriage-control device 

TTY - Terminal device 

DIR - File-structured device 

SDI - Single directory device 

SQD - Sequential device 

MSD - Mass storage device 

EXT - Unit on extended 22-bit UNIBUS controller 

UMD - User-mode diagnostics supported 

MBC - MASSBUS device 

SWL - Unit software write locked 

ISP - Input spooled device 

OSP - Output spooled device 

PSE - Pseudo device 

COM - Device is mountable as COM channel 
Fll - Device is mountable as Files-11 device 
MNT - Device is mountable 

14. Second device characteristics word, using the following 
three-letter codes: 

DH1 - Unit is a multiplexer 

DJ1 - Unit is a DJ11 

RMT - Unit is remote 

HFF - Unit handles hardware form feeds 
NEC - Solicited input not echoed 
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Item Description 

CRT - Unit is a CRT 

ESC - Unit generates escape sequences 

-LOG - User not logged in on terminal 

SLV - Unit is a slave terminal 

DZ1 - Unit is a DZ11 

HLD - Terminal is in hold screen mode 

AT. - MCR command AT. is being processed 

PRV - Unit is a privileged terminal 

L3S - Unit is a LA30S terminal 

VT5 - Unit is a VT05B terminal 

LWC - Lowercase to uppercase conversion 

15. Terminal status word, using the following three-letter 
codes : 

RST - Read with special terminators in progress 

RUB - Rubout sequence (non-CRT) in progress 

ESC - Escape sequence in progress 

RAL - Read pass all in progress 

RNE - Echo suppressed 

CTO - Output disabled 

OB Y - Output busy 

IBY - Input busy 

BEL - Bell pending 

DPR - Defer processing of character in buffer 

DEC - Defer echo of character in buffer 

DSI - Input processing disabled 

CTS - Output stopped by CTRL-S 

USI - Unsolicited input in progress 

OBF - Buffered output in progress 

IBF - Buffered input in progress 
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Item Description 

16. Second terminal status word using the following 
three-letter codes: 

ACR - Wrap-around required 

CR - Trailing carriage return required on output 

BRQ - Break-through write is queued 

WRA - Control for wraparound 

SRQ - Special request is queued 

WRB - Low bit in 52-WRA bit pattern 

ORQ - Output request is queued 

IRQ - Input request is queued 

HFL - Horizontal fill required 

VFL - Vertical fill required 

HHT - Hardware horizontal tab is present 

HFF - Hardware form-feed is present 

FLF - Force line feed before next echo 

FDX - Line is full duplex mode 

17. Fourth terminal status word, using the following 
three-letter codes: 

RAL - Terminal is in read-pass-all mode 

WES - Task waiting for escape sequence 

RPO - Read with prompt output in progress 

TAB - Type-ahead buffer allocation requested 

8BC - Pass eight bits on input 

ABD - Autobaud speed detection enabled 

RCU - Restore cursor 

ABP - Autobaud speed detection in progress 

WAL - Terminal is in write-pass-all mode 

VER - Last character in type-ahead buffer has a parity 
error 
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Item Description 

BCC - Last character in type-ahead buffer has a framing error 

DAO - Last character in type-ahead buffer has a data overrun 
error 

PCU - Position cursor 

NOTE 

On RSX-11M systems that use the half-duplex 
terminal driver, CDA dumps two terminal status 
words. 

UNIT CONTROL BLOCK 

18. Octal dump of Unit Control Block (UCB) , including 
negative offsets, and octal dump of UCB extension if a 
UCB extension is present 

DEVICE CONTROL BLOCK 

19. Octal dump of Device Control Block 

STATUS CONTROL BLOCK 

20. Octal dump of Status Control Block 

I/O REQUEST PACKETS 

21. Address of the first word of the I/O packet 

22. Name of the task requesting I/O 

23. Priority of the task requesting I/O 

24. Event flag number used to signal I/O completion 

25. Logical unit number used by requesting task 

NOTE 

If the task was checkpointed while the packet was 
queued, this number may not be correct. If the 
address in I.LN2 is within the task header, the 
logical unit number is correct. 

26. I/O function codes (for detailed information on the legal 
I/O function codes for each device, refer to the 
RSX-11M-PLUS I/O Drivers Reference Manual) 

27. Status of the I/O request - current or queued 

28. Octal dump of I/O request packet in offset mode 

29. I.LN2 - pointer to the second word of the LUN 
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RSX-ilM CRASH DUMP ANALYZER 2-^AY-85 1 5 1 1 3 

DEVICE INFORMATION 



PAGE 110 



TT11 I 



UCB ADR 


OCB 


ADR 


SCB ADR 


040474 


037630 


s **a « « a 

044266 


U t S T S | 








U , S T 2 | 








U.CTLi 


QUE 


PWF 


ATT KIL 


U.CWli 


TTY 


CCL 


REC 


U.CW2I 


DHl 


CRT 


PRV LWC 


U.TSTAj 




I BY 


IBF 


U.TSTA+21 




ACR 


ORQ IRQ 


U,TSTA*4| 




TAB 





ACP ATT OWNER LOGIN UIC 

mmm mmm • 

...MAI NONE [7,37] 



UNIT CONTROL BLOCKi 

040466 000000 003437 000000 

040506 102011 000335 000120 

040526 000100 141730 000030 

040546 000000 000000 000000 

UNIT CONTROL BLOCK EXTENSION! 

145100 075670 146730 146734 

145120 127147 000001 146734 

145140 000000 013400 000000 

DEVICE CONTROL BLOCK t 

037630 044434 037674 052124 

037650 160000 000000 000007 

STATUS CONTROL BLOCKi 

044260 100200 000011 000004 

044300 160020 067454 031000 

044320 044316 035240 001000 



037630 040474 
044266 056604 
000001 013400 



000044 
146470 
023531 



030001 

000000 



000000 

170500 
000002 



000054 
000000 



000060 
000001 



044266 
000000 
160040 



000474 000010 000007 
145100 100200 050301 
003437 000015 000004 



146730 000000 000000 
003000 002400 000022 



121274 163177 000130 
000006 114670 



034240 001000 000000 
000000 001200 000000 



I/O REQUEST PACKETSl 

PACKET ADR REQUESTOR PRI EFN LUN 
1*75670 65. 32. 5. 



FUNCTION CODE 
IO.RLB 



STATUS 

INPUT 



0000P0 000-400 1320101 056604 074354 340474 301000 057220 017645 
/0<*020 140020 000000 000572 141*040 000120 100000 000000 000056 
000040 000020 075624 



Figure 3-17 Device Information and I/O Packet (Truncated) 
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3.2.8 System Task Directory 

CDA scans the System Task Directory and outputs the information 
contained in Figure 3-18. The information in this format is identical 
to the first 17 items described in Figure 3-11 of this manual. 



RSX-MM CRASH DUMP ANALYZER V«.2 2-KAY-8.5 

SYSTEM TASK DIRECTORY 



15115 



PAGE 31 



. LDR, 

TCB ADDRESS ■ 041572 PAR s LDR PCB ADDRESS « 041536 

LOAD ADDRESS ■ 000000*10 LOAD DEVICE * LB0 LBN s 00000000 

PRI « 248. I/O COUNT • 0, UIC s tl#U TI s CO0 

MAX SIZE » 000000 EVENT FLAGS s <1-16> 000001 <17-32> 000000 

T.STAT | 

T.8T2I -CMK FXD STP 
T.ST3I PRV 



1900000 
000020 
000040 
000060 



000000 000370 000000 127414 015754 000000 041604 000000 

041610 000001 000000 041304 U4564 000000 022020 010000 

000370 000000 041354 041536 000000 115264 000000 041646 

000000 000000 000000 041656 000000 041662 000000 000000 



TKTN 

TCB ADDRESS m H4564 PAR ■ SYSPAR PCB ADDRESS s 

LOAD ADDRESS 3 00137200 LOAD DEVICE « LB0 LBN s 00057410 

PR I • 246. I/O COUNT a 0. UIC ■ [0,0] TI « NONE 

MAX s x ZE ■ 000105 EvENj FLAGs » <1-16> 000000 <17-32» 000000 

T.STATi -EXE OUT 

T.ST2I 

T.ST3I -PMD PRV CAL 

000000 000000 000370 000000 077314 053600 000000 114576 000000 

000020 1H602 000000 000000 000000 116064 100400 000000 050100 

000040 000370 057410 041354 117074 000105 000000 000000 000000 

000060 114642 000000 000000 000000 114652 000000 114656 000000 

Figure 3-18 System Task Directory (Truncated) 
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3.2.9 Pool Dump 

As shown in Figure 3-19, CDA prints the system pool in octal, 
Radix-50, and ASCII. On RSX-11M-PLUS systems with secondary pool 
support, CDA prints a dump of secondary pool with the /SECPOL switch. 
If a line is repeated more than nine times, CDA prints it once and 
then prints a message indicating the number of identical lines. 

The symbols in Figure 3-19 have the following meanings: 

* Indicates that the next word is allocated. 

+ Indicates that the next word is contained in an unused, 
preallocated I/O packet (in $PKAVL free list). 



NOTE 

$PKAVL is a list containing fixed-size blocks. The 
blocks in this list are used for fast allocation, 
and I.LGTH determines the length of these blocks. 

Indicates that the next word is allocated in both $CRAVL and 
$PKAVL. (This is an error condition) . 



NOTE 

$CRAVL is the free pool list head. 
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RSX-1JM CRASH DUMP ANALYZER V4.2 2-HAY--85 1 5 1 1 5 PACE 42 

POOL DUMP 

SYSTEM POOL 
* s NEXT WORD ALLOCATED FIRST FHEE 9L0CK (fCRAVL) x 041760 



♦ B 


NEXT 


InORD IS 


IN SPKAVL 


LIST 






SPKAVL 


b 042120 




• S 


NEXT 


WORD IS 


IN SPKAVL 


AND ALSO 


IN JCRAVL 










041674 


* 


000000 


* 


042710 


* 


042164 


* 


042164 1 




KFX 


J80 


J8D1 


1 HEtOtD 


0417(94 


* 


00040(4 


* 


000002 


* 


003204 


* 


0004^7 I 


FP 


8 


AA, 






041714 


* 


000007 


* 


002400 


* 


0021 12 


* 


000401 I 


G 


2 


$R 


FQ i 


1 J 


041724 


* 


000000 


* 


000030 


* 


160000 


* 


000000 1 




X 


53X 




■ « 


041734 


* 


177^00 


* 


002347 


* 


051522 


* 


030530 1 


2 


10 


MM J 


G52* 


1 g RSXl 


041744 


* 


046461 


* 


046102 


* 


032462 


* 


000000 J 


LNA 


LHB 


HJR 




11MBL25 


041754 


* 


000000 


* 


044506 




042014 




000004 1 




K. 8 


J5T 


Dl 


1 FI D 


041764 


* 


000000 




000225 


* 


115764 


* 


000000 1 




c/ 


X8D 




1 t 


041774 


* 


000003 


* 


1 17074 


* 


041764 


* 


000240 I 


C 


YL. 


J46 


1 


1 < tc 


0420C4 


* 


115264 


* 


000000 


* 


000003 


* 


Il7a7a l 


X0D 




C 


YL.l 


1 4 < 


042014 




042064 




000004 




042264 




000044 1 


J6T 


D 


J9, 


61 


UD 4DS 


042024 




000020 




000000 


* 


040212 


♦ 


001010 1 


P 




JMB 


M 1 


1 • 


042034 




121200 




0021 1 1 


♦ 


140000 




000000 1 


Z 


$Q 


0.2 




1 " I • 


042044 


♦ 


000020 


♦ 


012054 




001350 




000000 1 


P 


CIO 


RX 




1 t h 


042054 




000553 




001016 


♦ 


000000 


♦ 


000000 1 


IC 


MF 






1 k 


042064 




042240 




000034 




115264 




007422 1 


J9H 


■ 


X0O 


BPR1 


1 D 4 


042074 




000000 




000000 




100000 




115306 1 






TSM 


X0V1 


1 F 
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042240 




000014 




000000 




000000 1 


J9M 


L 






1 D 


042114 




000003 




00001 1 




042020 


* 


000044 1 


C 


I 


J5X 


61 


1 OS 


042124 




000020 


♦ 


000000 




041016 




000400 i 


P 




JV0 


FP1 


I 8 


042134 




120426 




001376 




140026 




000000 1 


Y08 


SF 


0/N 




1 I* P 


042144 




001412 


♦ 


140047 
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000003 




000000 I 


SR 
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I 
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000000 




000000 
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A 


A 
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000000 
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SR 
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000000 
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000000 


* 
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* 


000000 


* 
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000024 1 




ZJB 


K X 


Tl 


1 sxo 


042244 




1 15264 




005374 




000000 




000000 1 


X0D 


A0L 






14 1 


0<j225a 




100000 




1 153^6 
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00000a 1 


TSM 


X0V 


KGX 


01 


1 F DE 


042264 


♦ 


042504 


♦ 


0021 14 


♦ 


140054 




000000 1 


KCL 


ST 


0/6 




1 DEL ,«» 


042274 


t 


04P212 




001000 




120636 




001400 1 


JMB 


L2 


Y4N 


Shi 


1 • 1 


0423(14 


♦ 


140036 




000000 


♦ 


000000 




141750 1 


0/V 






1M21 


1 • hC 


042314 




001000 


♦ 


000000 




000040 




000025 1 


12 




2 


UJ 




042324 




000000 




000020 




042550 




000154 1 




p 


KDH 


B.I 


1 hEl 


042334 




050061 




020105 




030066 




000415 1 


L3I 


EFU 


G.V 


F/l 


11PE 60 


042344 
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000000 1 


8P0 


Y0L 


Y.J 




1 Pi * 


042354 




000000 




120712 




00001 6 




0000^0 j 




Y5R 


N 




1 Jl 
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000000 




0M0000 




000000 




000000 1 












042374 




042436 
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000000 




000000 I 
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1 E 
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000000 
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000000 
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Figure 3-19 Pool Dump (Truncated) 
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RSX-UN-PLUS CRASH DUMP ANALYZER V3.0 2-."AY-85 13155 PAGE 1 

SECONDARY POOL OU*P 

SECONDARY POOL 



NUMBER OF FREE BYTES * 00037500 FIRST FREE BYTE a 00656700 

LENGTH c 00120000 BYTES 

START ADDRESS s 00625000 ENDING ADDRESS s 00627500 
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000000 


131574 


1 


AY 




. • . » 
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000000 
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1 
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Figure 3-19 (Cont.) Pool Dump (Truncated) 
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3.2.10 Task Dump 

CDA prints all or a portion of the task's virtual address space if the 
/TASK switch is specified. Figure 3-20 and the following list 
illustrate this output. 

Item Description 

1. Task name 

2. Address of the first word of the Task Control Block for 
the task 

3. Address of the first word of the task's header 
WINDOW BLOCKS 

4. Name of the partition to which the task is mapped 

5. Task virtual address limits 

6. Address of the attachment descriptor 

7. Size of window in 32-word blocks 

8. Offset to memory region within partition in 32-word 
blocks 

9. First Page Description Register (PDR) used to map the 
task 

10. Number of PDRs used to map task 

11. Contents of the last PDR used to map the task 

12. Task virtual address limits 

13. Physical starting address of the memory region being 
dumped 

14. Dump of the data within the window, formatted in octal, 
Radix-50, and ASCII 
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RSX-11M CRASH DUMP ANALYZER va,2 2-MY-85 

TASK DUMP 



1 3 J 52 



PAGE 1 



TASK DUMP OF ...MCR 



© 



TCB ADDRESS s 115264 



HEADER ADDRESS i 
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WINDOW BLOCKSi 

© © 
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mmm v at « * • ■ « a s a ■ 

SYSPAR 120000 130477 



© © ® ® ® © 
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Figure 3-20 Task Dump (Truncated) 
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3.2.11 Clock Queue 

The example in Figure 3-21 shows a clock queue listing. The following 
list explains the example. 

Item Description 

1. Address of the clock queue entry 

2. Types of time schedule requests 
One of the following types: 

Type - Mark time request 

Type 2 - Request with periodic rescheduling 
Type 4 - Single-shot task request 

Type 6 - Single-shot internal system subroutine with 
system subroutine identification 

Type 10- Single-shot internal system subroutine 
without system subroutine identification 

Type 12- Clear stop bit (Shuffler) 

3. Task Control Block address or system subroutine 
identification 

4. Task issuing the clock request 

5. The hour, minute, and second that time request comes due 

6. This field varies with each type of time schedule request 
For a Mark Time request, the labels are: 

CAST - AST address 

C.SRC - Event flag mask word 

C.DST - Event flag mask address 

Event Flag Number 

For a periodic rescheduling request, the labels are: 

C.RSI - Reschedule internal 

C.UIC - Scheduling UIC 

The field for a single-shot task request contains only 
one label: 

C.UIC - Scheduling UIC 

The field for a single-shot internal subroutine (both 
with and without system subroutine identification) 
contains : 

C.SUB - Subroutine address 

C.AR5 - Relocation base address (for loadable 
drivers) 

7. Octal dump of clock queue in offset mode 
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R8X-HM CRASH DUMP ANALYZER V«.2 2-*AY-85 15U3 PACE 116 
CLOCK QUEUE 

© ® ® © 

ADDRESS ■ 054210 REQUEST TYPE a TCB « 107134 TASK a TKTN 

TIME REQUEST BECOMES DUE s 09l54j06.8® 

C, AST * 000000 C.SRC « 100000 C.DST * 107156 EVENT FLAG = 16,® 
000000 057250 010000 107134 011374 000000 000000 100000 1 7 1 5 6 j 7 

ADDRESS s 057250 REQUEST TYPE « TCB s 053510 TASK - PMT.,, 
TIME REQUEST BECOMES DUE s 09|54U0,2 

CAST = 124602 C.SRC = 000002 C.DST 3 053532 EVENT FLAG = 2. 
000000 046760 001000 053510 011707 000000 124602 000002 053532 

ADDRESS a 0U6760 REQUEST TYPE a TCB * 053510 TASK s PMT.,, 
TIME REQUEST BECOMES DUE s 09|54|50.2 

CAST = 000000 C.SRC = 000004 C.DST a 053532 EVENT FLAG s 3. 
000000 000000 001400 053510 016447 000000 000000 000004 053532 



Figure 3-21 Clock Queue 



3.2.12 Controller Information 

Figure 3-22 shows the information associated with a device controller. 
This information appears only in crash dumps of RSX-11M-PLUS systems. 
The following list explains the items in Figure 3-22. 

Item Description 

1. Name of the device controller 

2. Address of the Controller Table (CTB) 

3. Address of the Device Controller Block (DCB) for this 
device ■ 

4. CTB status byte, which may contain any of the following 
three-letter status codes: 

CLK - Clock block appears at the top of the CTB 
MDC - Multidriver CTB 

CBL - Clock block is linked into the clock queue 

CIN - Controller uses the common interrupt dispatch 

table' 1 
NET - DECnet device 

5. Octal dump of the CTB 

6. Common Interrupt Address 
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Item Description 

7. DCB for each device interfaced by this controller 

8. Name of each device interfaced by this controller 

9. Address of the Controller Request Block {KRB} 

10. Controller status. The following is a list of possible 
status values and their meanings: 

OFL - Controller is off line 

MOF - Controller is marked for off line 

UOP - Controller supports overlapped operations 

MBC - Device is a MASSBUS controller 

SDX - Seek operations allowed during data transfers 

POE - Parallel operations enabled 

UCB - UCB table present 

DIP - Data transfer in progress 

PDF - Privileged diagnostic functions only 

11. Octal dump of KRB in one or two parts 



RSX-UM-PLUS CRASH DUMP ANALYZER V3,0 2»f*AY«85 15108 PACE 149 

CONTROLLER INFORMATION 



~ H © ® 

CTB ADDRESS * 020454 L.DC8 * 022020 

© L.STSl HOC CIN 

CONTROLLER TABLE BLOCK 

020454 H22200 044122 C2202® £05004 022044 022102 022134 022160 



}© 



DEVICES INTERFACED BY THIS CONTROLLER 
COMMON INTERRUPT ADDRESS « 017526 (?) 
0DCB DEVICE NAME @ w 

020474 DB 

021142 OR 

021410 DS 

021616 MM 

KRB ADDRESS ■ 022044® 
K.STSl SDX UOP MBC POE UCB DIP© 

~\ 

022026 021410 021616 000000 177777 025640 000400 000374 176700 
022046 000016 000003 020534 021112 021112 000050 020534 020602 
022066 020650 020716 177777 015240 



022046 000016 000003 020534 021112 021112 000050 020534 020602 

022066 020650 020716 

KRB ADDRESS * 022102 

K.STSl SDX UOP MBC POE UCB 

022064 020602 020650 020716 177777 015240 000002 000174 176300 

022104 000016 000001 000000 000000 022112 000050 021202 021252 

022124 177777 020640 000004 000030 

022104 000016 000001 000000 000000 022112 000050 021202 021252 



Figure 3-22 Controller Information 
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KRB ADDRESS » 022134 
K,5l8i SDK *8C 

012116 000050 021202 
022136 000016 000001 
022156 000030 17244a 

022136 000016 000001 



021252 177777 020640 

02(516 000000 022144 

000016 000000 

021516 000000 022144 



000004 000030 172040 
000030 022640 000006 

000030 022640 000006 



KR8 ADDRESS « 022160 
K.STSt SDK MBC 

022142 021516 000090 
022162 000016 00000(9 
022202 045504 022212 

022162 000016 22)0202 



022144 000030 022640 

000000 000000 022170 

000001 022372 

000000 000000 022170 



000006 000030 172440 
000034 004270 022454 

000034 004270 



Figure 3-22 (Cont.) Controller Information 



3*2*13 Kernel Data Space 

Figure 3-23 shows a dump of kernel data space from the specified 
starting virtual address to the specified ending virtual address. 



3.2.14 Kernel Instruction Space 

Figure 3-24 shows a dump of kernel instruction space from the 
specified starting virtual address to the specified ending virtual 
address • 



3.2.15 Task Data Space 

Figure 3-25 shows a dump of task data space. This dump occurs only on 
RSX-11M-PLUS systems. 



3. 2. 16 Task Instruction Space 

Figure 3-26 shows a dump of task instruction space . This dump occurs 
only on RSX-11M-PL0S systems. 
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RSX-UM*PLUS CRASH DUMP ANALYZER V3.0 2-MAY-85 1 2 f 5 1 PAGE 6 

KERNEL DATA SPACE DUMP 
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[END OF ANALYSIS OUTPUT] 

Figure 3-23 Kernel Data Space 
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R8X-U«»PtUS CRASH OUMP ANALYZER V5.0 2«MAY»85 12tSl RASE 5 

KERNEL. INSTRUCTION SPACE DU*P 
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Figure 3-24 Kernel Instruction Space 
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RSX-llM-PLUS CRASH DUMP ANALYZER 



V3.0 



2-MAY-85 16113 



PAGE 1 



TASK DUMP OF LIH27 



DAT* SPACE 



TCB ADDRESS * 042204 



HEADER ADDRESS a 011323 



WINDOW BLOCKS: 



PAR 

GEN 



VIRT LIMITS ATT DESC WND SIZE OFFSET 1ST PDR NO, LAST POP 



000000 002077 040030 000021 
160000 160177 041040 000002 



000015 177620 1 010006 
000010 177636 1 000402 
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Figure 3-25 Task Data Space 
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ANALYSIS LISTINGS 



R3XM1M.PLUS CRASH DUMP ANALYZER V3,«J 2-MAY-85 13146 PAGE 1 

TASK DUMP 



TASK DUMP OF , , , LDR 



INSTRUCTION SPACE 



TC8 ADDRESS s U7300 HEADER ADDRESS * 117130 
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Figure 3-26 Task Instruction Space 
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CHAPTER 4 
INTERPRETING A CRASH DUMP LISTING 



This chapter introduces basic concepts that can help you to use CDA 
output listings to analyze the cause of a system crash. However, this 
chapter is not intended as a complete guide to interpreting a crash 
dump. 



4.1 HELPFUL CONCEPTS 

Two concepts are helpful in using CDA output listings to determine the 
cause of a system failure: 

• Determining what was mapped at the time of the crash 

• Interpreting stack depth and the kernel stack 



4.1.1 Determining What Was Mapped 

To determine what was mapped at the time of the crash, look at the 
dump of the Kernel Page Address Registers on the first page of the CDA 
listing (instruction space registers on RSX-11M systems, both 
instruction and data space registers on RSX-11M-PLUS systems) . This 
listing, titled Volatile Registers, is shown in Figure 3-1. 

Figure 4-1 is an example of the listing of the contents of the sixth 
and seventh words from a Kernel Page Address Registers dump. The 
contents of the sixth and seventh words are the block numbers of the 
task or driver that was mapped at the time of the crash. You can 
determine what occupied that portion of memory from the memory map on 
the first page of partition information in the CDA output listing. 
Look under the BASE heading (for the base address of the mapped 
partition) . 

You can use this information, along with data from the kernel stack 
and system common listings, to analyze the state of the system at the 
time of the crash. 
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KERNEL 



I S 
PDF? 



SPACE 
PAR 



D S 
PDR 



PACE 
PAR 



077506 
077506 
077506 
077406 
077506 
077406 
077406 
077506 



001372 
002077 



007600 



000000 
000200 
000400 
000600 
001000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 



Figure 4-1 Kernel Page Address 



Registers 



4.1.2 Interpreting the Kernel Stack 

$STKDP, which appears on the first page of the system common listing, 
is the system stack depth indicator. The value of the stack depth 
indicator shows which state the system was in when it crashed. The 
following lists shows the possible values of the stack depth indicator 
and the corresponding system states. 

$STKDP = 1 Indicates User state 

$STKDP = Indicates System state 

$STKDP = -1,-2,-3,-4,... Indicates Interrupt state 

Note that when the system is in Interrupt state, the stack depth value 
is negative. Two types of interrupt conditions can decrement stack 
depth : 

1. A synchronous system trap (SST) , which can be caused by any 
of the following: 

• A directive 

• A TRAP instruction 

• An illegal instruction 

• Another SST 

2. The interrupt save routine ($INTSV) 

When an SST occurs, the following information from the current task is 
pushed onto the stack: 

The Processor Status Word (PSW) 

The Program Counter (PC) 

The address of return to DIRSV 

SST specific information 

R5 (Mapped systems only) 

R4 (Mapped systems only) 

R3 

R2 

Rl 

RO 
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When an interrupt occurs, the following are pushed onto the stack: 

PSW 
PC 

If a call to $INTSV is then issued, the following are pushed onto the 
stack after the PC: 

Address of return to $INTSV 

R5 

R4 

The stack depth is then decremented. If the value of $STKDP is and 
the currently mapped driver issues a call to the $FORK routine, the 
following items are pushed onto the stack: 

Return to $FORK 

R3 (Which replaces the return to $INTSV) 

R2 

Rl 

RO 

If the driver issues a call to $FORK when $STKDP is not 0, the 
registers are saved in a fork block, which is queued for later 
execution . 

Since interrupts can still occur, more of both basic types of stack 
contents (interrupt or $INTSV) can be pushed. If an SST occurs in the 
Executive, SST information will be pushed onto the stack, possibly 
followed by a system crash. 

This information, along with the kernel stack pointer SP(K), which 
appears on the first page of the CDA listing, can be used to interpret 
the contents of the dump of the kernel stack. 

The contents of the PC and the PSW before the crash appear on the 
first page of the CDA listing. You can compare this information to 
the contents of the PC and the PSW on the stack to help locate the 
cause of the crash. 

Refer to the RSX-llM Guide to Writing an I/O Driver or to the 
RSX-llM-PLUS Guide to Writing an I/O Driver for a further description 
of the contents of the kernel stack. 
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APPENDIX A 
CDA MESSAGES 



CDA displays a message on your terminal when it detects one of the 
error conditions described below. These messages reflect operational 
conditions. Do not confuse these messages with the diagnostic 
analysis messages that CDA generates during the analysis and prints in 
the analysis listing. 

Not all of the messages listed below terminate CDA analysis. Some are 
simply informational messages, and others warn you of nonfatal errors. 
Also, this list includes some ANALYZE/CRASH_DUMP command error 
messages . 



ANALYZE — Illegal crash input specification 
Type: Fatal 

Explanation: You must include a crash-input device or file in 
the command line. Also, you must use the correct command line 
syntax when you specify the crash input. 



ANALYZE — Illegal crash output specification 
Type: Fatal 

Explanation: You must specify at least one output file or 
device specification. Also, you must use the correct command 
line syntax when you specify the crash output. 



ANALYZE — Illegal, contradictory, or ambiguous qualifiers 
Type: Fatal 

Explanation: You must use qualifiers with the correct file or 
device specification. Refer to the qualifier tables in Chapter 2 
if you are unsure which file or device specification a qualifier 
modifies. Also, when you specify qualifier arguments, be sure to 
enclose them in parentheses. If you specify more than one 
argument for the same qualifier, separate the arguments with 
commas . 



ANALYZE — Sorry, task not installed 
Type: Fatal 

Explanation: CDA is not presently installed in the system. If 
you are a nonpri vileged user, refer to Chapter 1 for an 
explanation of how you can run CDA as an uninstalled task, or ask 
a privileged user (such as your system manager) to install CDA. 
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If you are a privileged user, you can install CDA and then 
reenter your command line. 

CDA — ACP out of memory or not in execution 
Type: Analysis diagnostic 

Explanation: The partition containing the File Control Block 
(FCB) for the current logical unit number (LUN) was not in 
memory . 



CDA — Address out of range 
Type: Fatal 

Explanation: CDA was unable to read a block from the crash-input 
file. Possible causes for this are: 



• 


A device failure 




• 


A bad block on the volume 




• 


The crashed system had a corrupted data 


base 


• 


The binary file does not contain all of 


the crashed system's 



memory 



CDA — Analysis output must be directed to an explicit device or file 
Type: Fatal 

Explanation: CDA requires an explicit output file specification. 
There are no default output file names. 



CDA — Analysis terminated after n. pages 
Type: Informational 

Explanation: CDA terminated the analysis after generating n 
pages of analysis output. If you have not specified the /LIMIT 
switch in the CDA command string, this message indicates that CDA 
has generated more than 300 (decimal) pages of output. 

CDA — Command I/O error 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 
read a command line. 



CDA — Command line syntax error 
Type: Fatal 

Explanation: CDA detected an error in the syntax of a CDA 
command line. CDA will point to the beginning of the error 
within the command line. 
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CDA — Crash dump must be input from an explicit device or file 
Type: Fatal 

Explanation: The crash dump input file specification must be 
explicit. There is no default file specification for the crash 
dump input. 

CDA — Device driver missing 
Type: Fatal 

Explanation: You have not loaded the driver for the crash dump 
input device. 

CDA -- Dump aborted - kernel PARs clobbered 
Type: Fatal 

Explanation: This message appears on mapped systems only. It 
indicates that the values contained in the kernel Page Address 
Registers are invalid. To restart the analysis, you must specify 
the /KMR switch. This switch forces CDA to use standard mapping 
values when converting kernel virtual addresses to physical 
memory addresses. 

CDA — Error reading crash dump 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 
read the crash dump file. This could be caused by: 

• A device failure 

• A bad block on the volume 

• On RSX-11M-PLUS systems, the device might not be mounted 
foreign 

CDA — Error reading file filename 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 
read the crash dump file. This could be caused by: 

• A device failure 

• A bad block on the volume 

CDA — Error reading symbol file filename 
Type: Fatal 
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Explanation: The system returned an error when CDA attempted to 
read the symbol table file indicated. Possible causes for the 
error are: 

• A device failure 

• A bad block on the volume 

• The specified symbol file was not an STB file 

CDA — Errors detected: n. 
Type: Informational 

Explanation: CDA has detected n analysis errors during the run. 

CDA — Error writing analysis file 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 
write a line into the analysis listing file. This could be 
caused by: 

• A full volume 

• A problem with the device 

• A bad block on the volume 

CDA — Error writing dump file filename 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 
write into the binary output file. This condition could be 
caused by: 

• A full volume 

• A problem with the device 

• A bad block on the volume 

CDA — Exiting due to illegal trap - snapshot dump being attempted 
Type: Fatal 

Explanation: CDA has aborted after detecting an odd address or 
some other type of fault. If Postmortem Dump (PMD) is installed 
in the system, the system will generate a snapshot dump. This is 
an indication of a software problem. If you send a Software 
Performance Report (SPR) to DIGITAL for this type of failure, you 
should include any available dumps. 



A-4 



CDA MESSAGES 



Also, preserve the following until your SPR is answered: 

1. From the crashed system: 

• All applicable user task images 

• RSX11M.SYS 

• RSX11M.STB 

• RSXMC.MAC 

• All applicable privileged task images 

• Crash dump volume 

2. From the system used for analysis: 

• RSX11M.SYS 

• RSX11M.STB 

• CDA.TSK 

CDA — Failed to assign LUN to input device ddu 
Type: Fatal 

Explanation: The Assign LUN (ALUN$) directive failed when CDA 
attempted to use it to attach the specified input device before 
reading the crash dump from the device. ALUN$ will fail if the 
device name in the CDA command line is invalid. 

CDA — Failed to extend page buffer - n. pages available 
Type: Informational 

Explanation: The Extend Task (EXTK$) directive failed when CDA 
attempted to use it to expand the page buffer. This problem will 
cause the analysis to take longer, but the analysis will continue 
with a buffer of n pages, each 256 words long. 

NOTE 

CDA uses the Extend Task directive to obtain 
additional buffering space. CDA does not use 
space allocated by a /INC= qualifier on the 
INStall command. 

CDA — Failed to open input file filename 
Type: Fatal 

Explanation: One of the following conditions exists: 

• The specified device does not exist. 

• The volume is not mounted. 

• A problem exists with the device. 
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• The specified UFD does not exist. 

• The specified file does not exist. 

• You do not have read access privileges. 

CDA — Failed to open output file filename 
Type: Fatal 

Explanation: One of the following conditions exists: 



• 


The specified device does not exist. 




• 


The volume is not mounted. 




• 


A problem exists with the device. 




• 


The specified UFD does not exist. 




• 


The volume is full or the device is write- 


-protected . 


• 


You do not have write access privilege to 


UFD. 



CDA — Illegal switch 
Type: Fatal 

Explanation: You specified an unknown switch or used a legal 
switch with the wrong file specification. CDA will point to the 
error within the command line. 

CDA — Inconsistency in dynamic storage 
Type: Informational 

Explanation: CDA detected an inconsistency while scanning the 
pool pointers. This condition could be associated with the 
crash. However, it may mean that you specified the wrong 
executive symbol table file. 

CDA — Indirect command syntax error 
Type: Fatal 

Explanation: The name of the indirect command file (^filename) 
is syntactically incorrect. 

CDA — Indirect file open failure 
Type: Fatal 

Explanation: CDA could not open an indirect command file 
specified as "^filename" in the CDA command line. 



A-6 



CDA MESSAGES 



CDA — Invalid address range 
Type: Fatal 

Explanation: You specified an address that was not consistent 
with Active Page Register (APR) mapping. 

CDA — List count expired 

Type: Analysis diagnostic 

Explanation: The linked list of data structures has too many 
entries. The list may be corrupted, or contains a loop. 

CDA — Maximum indirect file depth exceeded 
Type: Fatal 

Explanation: You exceeded the maximum allowable number of nested 
indirect command files. (CDA only permits one indirect command 
level . ) 

CDA — No input file specified 
Type: Fatal 

Explanation: You did not specify a crash dump input file. 

CDA — No output file specified 
Type: Fatal 

Explanation: You did not specify an output file. 

CDA — Output dump filename must be explicit 
Type: Fatal 

Explanation: You did not specify a valid output file. 

CDA — Pool link error found - continuing 
Type: Analysis diagnostic 

Explanation: CDA detected a link error while scanning the pool 
free block pointers ($CRAVL) . This condition can be associated 
with the crash. It can also mean that you specified the wrong 
Executive symbol table file. If the latter is true, the entire 
analysis will be meaningless and you should abort CDA. 

CDA -- Premature end of dump input - filename being zero-filled 
Type: Informational 

Explanation: CDA reached the end of the medium (or the 
end-of-file mark on a magnetic tape) before the crash dump output 
file had been completely filled. If you expected the file to be 
completely filled by the dump, this condition could indicate a 
problem. 
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CD A — Processor n failed to dump its registers 
Type: Informational 

Explanation: On a multiprocessor system, when the system 
crashes, each on-line processor is notified by an interrupt. If 
the processor does not respond to the interrupt (for example, if 
it halted or is off line), it won't dump its registers into the 
crash buffer. CDA notes this and prints the informational 
message. 



CDA — Redirect error (U.RED=0) 
Type: Analysis diagnostic 

Explanation: CDA detected an error in the pointer to the Unit 
Control Block (UCB) of a redirected unit. This condition may be 
associated with the cause of the crash. 



CDA — Symbol symbolname not defined in symbol file 
Type: Fatal 

Explanation: CDA did not find a symbol that it required for the 
analysis in the specified Executive symbol table file. You have 
probably entered the wrong file name or have mistakenly used the 
default file name. 



CDA — Symbol file filename has illegal format 
Type: Fatal 

Explanation: The specified Executive symbol table file has an 
improper format, probably caused by entry of the wrong file name. 
However, this message could also indicate a problem with the 
device or medium on which the file is located. 



CDA — Task 1 taskname' not in memory 
Type: Analysis diagnostic 

Explanation: This message can be caused by two conditions: 

1. You have requested a dump of a task which does not have an 
entry in the System Task Directory 

2. The task has an entry in the System Task Directory, but it is 
marked out of memory. 

You can verify the state of the task by examining a dump of the 
Task Control Blocks. 



CDA — Transfer complete - ddu may be unloaded 
Type: Informational 

Explanation: The transfer of the crash dump to the output file 
is finished; you may unload the crash dump device. This message 
occurs only when you have specified a binary file in the output 
of the command string to CDA. 
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CDA — Unknown AST type 

Type: Analysis diagnostic 

Explanation: CDA has detected an AST block which is not one of 
the following valid types of ASTs: 

• Unsolicited character AST 

• Buffered I/O AST 

• Emit status AST 

• Completion AST from: 

QIO$ 

MRKT$ 

SPWN$ 

CNCT$ 

CINT$ 

1. Specified AST from: 

SFPA$ 
SRDA$ 
SRRA$ 
SPFA$ 



CDA — Unknown get command line error 
Type: Fatal 

Explanation: An unrecognized error occurred when CDA attempted 
to read a command line. 



CDA — $PKVAL link error at n — FWD PTR = n 
Type: Analysis diagnostic 

Explanation: CDA detected a link error while scanning the pool 
free packet list $PKVAL. This condition can be associated with 
the crash. It can also mean that you specified the wrong 
executive symbol table file. 
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APPENDIX B 

RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



This appendix describes the RSX-11M system macros that supply symbolic 
offsets for data structures listed in Table B-l. 

The data structures are defined by macros in the Executive macro 
library. To reference any of the data structure offsets from your 
code, include the macro name in an .MCALL directive and invoke the 
macro. For example: 

.MCALL DCBDF$ 

DCBDF$ ;Define DCB offsets 



NOTE 

All physical offsets and bit definitions are subject 
to change in future releases of the operating system. 
Code that accesses system data structures should 
always use the symbolic offsets rather than the 
physical offsets. 



The first two arguments, <:> and <=>, make all definitions global. If 
they are left blank, the definitions will be local. 

All of these macros are in the Executive macro library 
LB: [ 1,1]EXEMC.MLB. All except ITBDF$ and MTADF$ are also in the 
Executive definition library LB: [1, 1JEXELIB.0LB. 

Table B-l 

Summary of System Data Structure Macros 



Macro Arguments Data Structures 



ABODF$ 


<: 


>,< = > 


Task abort and termination 
notification message codes 


CLKDF$ 


<: 


>,< = > 


Clock queue control block 


DCBDF$ 


<: 


>,< = > 


Device Control Block 


EPKDF$ 


<: 


>,<=> 


Error message block 


EVNDF$ 


<: 


>,<=> 


Terminal Software Architecture 



(TSA) event packet definitions 



(Continued on next page) 
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Table B-l (Cont.) 
Summary of System Data Structure Macros 



Macro 




Arguments 


Data Structures 


F11DF$ 


<: 


>,< = > 


Files-11 data structures (volume 
control block, mount list entry, 
file Control Block, file window 
block, locked block list node) 


HUKUr 9 


s. . 


s s — s 


rPacV ho^r^Qy 3 n H w i rx^rtw Vi "I f"i r' If 
1 a b ]\ UcuUcl Cliili W1I1UUW UXwl_Jl 


HWDDF$ 


<: 


>,<=> 


Hardware register addresses and 

f pa fn re m;* c: If dpf l n i f i nn? 

1 Cu LUX. C llldofk UCl 1111 LXUllO 


ITBDF$ 


<: 


>,<=> 


Interrupt transfer block 


LCBDF$ 


<: 


>,<=> 


Logical assignment control block 


MTADF$ 


<: 


>,<=> 


ANSI magtape data strucures 
(volume set control block) 


PCBDF$ 


<: 


>,<=> 


Partition Control Block and 
attachment descriptor 


PKTDF$ 


<: 


>,<=> 


I/O packet, AST control block, 

nf f qht i nrr pnnf 1 V*> 1 o V nrnnn 

global event flag control block, 
and CLI parser block 


SCBDF$ 


<: 


>,<=> 


Status Control Block and UMR 
assignment block 


TCBDF$ 


<: 


>,<=> 


Task Control Block 


UCBDF$ 


<: 


>,<=>, TTDEF 


Unit Control Block 
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ABODF$ 



.MACRO ABODF$, L,B 



+ 

TASK ABORT CODES 



; nu Tfci : 


S 


•COAD-S.CFLT ARE ALSO 


SST VECTOR OFFSETS 


q CTlCT — 


D 


' A 


■ T1C7 cm-rr r SfTTVIi' 
1 AOn OllLiLi 1 1 V Ei 


c? TP vrp 

b . LLX1 - 


• 13 

D 


1 O 


.rnjVCV pVT1"PI?n MADMt r T V 

lAors. EjAI 1 I £jU NUKMALjLiX 


D • L.UAU- 


• n 

D 


U . 


\Juu AL/UKCibo AND lKAro 1U 4 


c ponr- 

O • V^O'oC — 


D 






S .CBPT= 


'B 


1 4 

** • 


•RRRAfC POTNT OR TRAfF TRAP 


S.CIOT= 


'B 


'6. 


IOT INSTRUCTION 


S.CILI= 


'B 


'8. , 


ILLEGAL OR RESERVED INSTRUCTION 


S.CEMT= 


'B 


'10. 


NON RSX EMT INSTRUCTION 


S.CTRP= 


B 


'12. 


TRAP INSTRUCTION 


S.CFLT= 


•B 


'14. 


•11/40 FLOATING POINT EXCEPTION 


S.CSST= 


'B 


•16. 


SST ABORT -BAD STACK 


S.CAST= 


■B 


'18. 


;AST ABORT-BAD STACK 


S.CABO= 


'B 


'20. 


ABORT VIA DIRECTIVE 


S.CLRF= 


'B 


'22. 


TASK LOAD REQUEST FAILURE 


S.CCRF= 


'B 


'24. 


•TASK CHECKPOINT READ FAILURE 


S. IOMG= 


'B 


•26. 


TASK EXIT WITH OUTSTANDING I/O 


S.PRTY= 


'B 


'28. 


TASK MEMORY PARITY ERROR 


S.CPMD= 


'B 


• 30. 


TASK ABORTED WITH PMD REQUEST 


S.CINS= 


'B 


'32. 


•TASK INSTALLED IN TWO SYSTEMS 



TASK TERMINATION NOTIFICATION MESSAGE CODES 



T 


. NDNR= : 


'B 


'0 


•DEVICE NOT READY 




NDSE= 'B 1 


2 


(DEVICE SELECT ERROR 


T 


,NCWF== 


'B 


'4 


;CHECKPOINT WRITE FAILURE 


T 


. NCRE= 


'B 


'6 


(CARD READER HARDWARE ERROR 


T 


. NDM0= 


'B 


•8. 


DISMOUNT COMPLETE 


T 


.NUER--= 


'B 


•10. 


( UNRECOVERABLE ERROR 


T 


. NLDN= 


'B 


'12. 


; LINK DOWN (NETWORKS) 


T 


.NLUP= 


•B 


•14. 


; LINK UP (NETWORKS) 


T 


,NCFI= 


•B 


'16. 


•CHECKPOINT FILE INACTIVE 


T 


.NUDE= 


•B 


'18. 


; UNRECOVERABLE DEVICE ERROR 


T 


,NMPE== 


•B 


•20. 


(MEMORY PARITY ERROR 


T 


. NKLF= 


'B 


'22. 


(UCODE LOADER NOT INSTALLED 


T 


. NDEB= 


•B 


'24. 


; TASK HAS NO DEBUGGING AID 


T 


. NRCT= 


•B 


'26. 


(CONTROL TASK NOT INSTALLED 


T 


.NWBL== 


'B 


'28. 


WRITE BACK CACHING DATA LOST. UNIT 
(WRITE LOCKED 


T 


.NPNT= 


•B 


'30. 


REQUIRED PARTITION NOT IN SYSTEM 


T 


.NI0S= 


'B 


'32. 


I/O STALLED 


T 


.NIOR= 


'B 


•34. 


I/O RESUMING 



.MACRO ABODF$ X,Y 

. ENDM 
. ENDM 
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. MACRO 



CLKDF$,L,B 



CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS 
CLOCK QUEUE CONTROL BLOCK 

THERE ARE SIX TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL 
BLOCK HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS 
IN THE REMAINING THREE. 

THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED: 



c 


•MRKT= 


•B 





;MARK TIME REQUEST 


c 


.SCHD= 


'B 


2 


; TASK REQUEST WITH PERIODIC RESCHEDULING 


c 


.SSHT= 


'B 


4 


;SINGLE SHOT TASK REQUEST 


c 


.SYST= 


•B 


6 


;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 










; (I DENT) 


c 


. SYTK= 


'B 


8. 


;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 










; (TASK) 


c 


.CSTP= 


'B 


10. 


;CLEAR STOP BIT (CONDITIONAL I ZED ON 



SHUFFLING) 

CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS 



.ASECT 

.=0 

C.LNK: 'L' .BLKW 1 

C.RQT: 'L 1 . BLKB 1 

C.EFN: 'L' .BLKB 1 

C.TCB: 'L' .BLKW 1 

C.TIM: 'L' .BLKW 2 



;CLOCK QUEUE THREAD WORD 
;REQUEST TYPE 

; EVENT FLAG NUMBER (MARK TIME ONLY) 
;TCB ADDRESS OR SYSTEM SUBROUTINE 
; IDENTIFICATION 

; ABSOLUTE TIME WHEN REQUEST COMES DUE 



; CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS 



,.=C.TIM+4 

C.AST:'L' .BLKW 1 

C.SRC:'L' .BLKW 1 

C.DST:'L' .BLKW 1 



; START OF DEPENDENT AREA 
;AST ADDRESS 

; FLAG MASK WORD FOR 'BIS' SOURCE 
; ADDRESS OF 'BIS 1 DESTINATION 



? CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET 
: DEFINITIONS 



.=C.TIM+4 

C.RSI : 'L' .BLKW 2 

C.UIC: 'L' .BLKW 1 



; START OF DEPENDENT AREA 
RESCHEDULE INTERVAL IN CLOCK TICKS 
; SCHEDULING UIC 
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CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS 

=C.TIM+4 ; START OF DEPENDENT AREA 

. BLKW 2 ;TWO UNUSED WORDS 

.BLKW 1 SCHEDULING UIC 

CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET 
DEFINITIONS 

THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST : ' L ' 

TYPE 6=S INGLE SHOT INTERNAL SUBROUTINE WITH A 16-BIT VALUE AS 
AN IDENTIFIER. 

TYPE 8 =S INGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS 
AN IDENTIFIER. 

.=C.TIM+4 ; START OF DEPENDENT AREA 

C.SUB:'L" .BLKW 1 ^'SUBROUTINE ADDRESS 

C.AR5:'L* .BLKW 1 RELOCATION BASE (FOR LOADABLE DRIVERS) 

.BLKW 1 ;ONE UNUSED WORD 

C . LGTH= 'B ' . ; LENGTH OF CLOCK QUEUE CONTROL BLOCK 

.PSECT 

.MACRO CLKDF$ X,Y 

. ENDM 
. ENDM 
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DCBDF 



.MACRO DCBDF$ 



DEVICE CONTROL BLOCK 

THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC 
INFORMATION ABOUT A DEVICE TYPE AND THE LOWEST AND 
HIGHEST UNIT NUMBERS. THERE IS AT LEAST ONE DCB FOR 
EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE, IF THERE 
ARE TELETYPES IN A SYSTEM, THEN THERE IS AT LEAST ONE 
DCB WITH THE DEVICE NAME ' TT 1 . IF PART OF THE 
TELETYPES WERE INTERFACED VIA DLll-A'S AND THE REST 
VIA A DHll, THEN THERE WOULD BE TWO DCB • S . ONE FOR 
ALL DL11-A INTERFACED TELETYPES, AND ONE FOR ALL DHll 
INTERFACED TELETYPES. 









ASECT 



















000000 


D. 


LNK: 


. BLKW 


1 , 


LINK TO NEXT DCB 


000002 


D. 


UCB: 


. BLKW 


1 


POINTER TO FIRST UNIT CONTROL BLOCK 


000004 


D. 


NAM: 


.BLKW 


1 


•GENERIC DEVICE NAME 


000006 


D. 


UNIT 


: . BLKB 


1 


; LOWEST UNIT NUMBER COVERED BY THIS DCB 


000007 






.BLKB 


1 , 


HIGHEST UNIT NUMBER COVERED BY THIS DCB 


000010 


D. 


UCBL 


: .BLKW 


1 


■LENGTH OF UNIT CONTROL BLOCK IN BYTES 


000012 


D. 


DSP: 


.BLKW 


1 , 


POINTER TO DRIVER DISPATCH TABLE 


000014 


D. 


MSK: 


.BLKW 


1 


•LEGAL FUNCTION MASK CODES 0-15. 


000016 






.BLKW 


1 , 


CONTROL FUNCTION MASK CODES 0-15. 


000020 






.BLKW 


1 , 


NOP 'ED FUNCTION MASK CODES 0-15. 


000022 






.BLKW 


1 , 


ACP FUNCTION MASK CODES 0-15. 


000024 






.BLKW 


1 


•LEGAL FUNCTION MASK CODES 16.-31. 


000026 






.BLKW 


1 , 


CONTROL FUNCTION MASK CODES 16.-31. 


000030 






.BLKW 


1 , 


NOP 'ED FUNCTION MASK CODES 16.-31. 


000032 






.BLKW 


1 , 


ACP FUNCTION MASK CODES 16.-31. 


000034 


D. 


PCB: 


.BLKW 


1 


; LOADABLE DRIVER PCB ADDRESS 








.PSECT 







; DRIVER DISPATCH TABLE OFFSET DEFINITIONS 

D.VDEB=177776 ;DEALLOCATE INTERNAL BUFFERS (FD TTDRV) 

D.VINI=0 ;DEVICE INITIATOR 

D.VCAN=2 ; CANCEL CURRENT I/O FUNCTION 

D.VOUT=4 ;DEVICE TIMEOUT 

D.VPWF=6 ;POWERFAIL RECOVERY 
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.MACRO EPKDF$,L,B 
Error Message Block Definitions 
., ASECT 



Header Subpacket 



Subpacket Length in 


Bytes 




Subpacket Flags 






Format Identification | Operating System Code 


Operating System Identification 


Flags 


l 


Context Code 


Entry Sequence 


Error Sequence 


+ — 




Entry Type Subcode 


l 

+ — 


Entry Type Code 


Time Stamp 






Reserved 


l 


Processor Type 


Processor Identification 


(URM) 



















E$HLGH 


: ' L 1 


.BLKW 


1 


E$HSBF 


: 1 L * 


.BLKW 


1 


E$HSYS 


• «L ' 


.BLKB 


1 


E$HIDN 


: ' L 1 


. BLKB 


1 


E$HSID 


: ' L ' 


.BLKB 


4 


E$HCTX 


'L' 


.BLKB 


1 


E$HFLG 


: 'L' 


.BLKB 


1 


E$HENS 


: 'L' 


. BLKW 


1 


E$HERS 


'L ' 


.BLKW 


1 


E$HENC 


* L 1 






E$HTYC 


' L ' 


.BLKB 


1 


E$HTYS. 


'L' 


.BLKB 


1 


E$HTIM 


* L ' 


.BLKB 


6 


E$HPTY 


'L' 


.BLKB 


1 






.BLKB 


1 


E$HURM 


. * L * 


.BLKW 


1 






.EVEN 




E$HLEN: 'L' 







Subpacket length in bytes 

Subpacket Flags 

Operating System Code 

Format Identification 

Operating System Identification 

Context Code 

Flags 

Entry Sequence Number 
Error Sequence Number 
Entry Code 
Entry Type Code 
Entry Type Subcode 
Time Stamp 
Processor Type 
Reserved 

Processor Identification (URM) 



Length 
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EPKDF$ (Cont.) 



Subpacket Flags for E$HSBF 



SM . ERR= 1 B * 
SM . HDR= * B ' 
SM.TSK='B 1 
SM.DID= 'B • 
SM.DOP= l B l 
SM.DAC='B' 
SM . DAT= * B ' 
SM.MBC= 'B 1 
SM.CMD= 'B ' 
SM . ZER= ' B ' 



1 
1 
2 
4 
10 
20 
40 
20000 
40000 
100000 



Codes for field E$HIDN 
EH$FOR= ' B ' 1 



Error Packet 
Header Subpacket 
Task Subpacket 

Device Identification Subpacket 
Device Operation Subpacket 
Device Activity Subpacket 
Data Subpacket 

22-bit massbus controller present 
Error Log Command Packet 
Zero I/O Counts 



; Current packet format 



Flags for the error log flags byte ($ERFLA) in the exec. 



ES.INI= , B' 
ES . DAT= 'B ' 
ES.LIM= 'B 1 
ES.LOG= 'B • 



1 
2 
4 
10 



Error log initialized 

Error log receiving data packets 

Error limiting enabled 

Error logging enabled 



Type and Subtype Codes for fields E$HTYC and E$HTYS 



Symbols with names E$Cxxx are type codes for field E$HTYC , 
symbols with names E$Sxxx are subtype codes for field E$HTYS. 



E$CCMD= 


'B' 


1 


; Error Log Control 


E$SSTA= 


•B 1 


1 


; Error Log Status Change 


E$SSWI= 


•B' 


2 


; Switch Logging Files 


E$SAPP= 


'B' 


3 


; Append File 


E$SBAC= 


'B 1 


4 


; Declare Backup File 


E$SSHO= 


•B' 


5 


; Show 


E$SCHL= 


'B 1 


6 


; Change Limits 


E$CERR= 


■B' 


2 


; Device Errors 


E$SDVH= 


'B' 


1 


Device Hard Error 


E$SDVS= 


■B' 


2 , 


Device Soft Error 


E$STMO= 


B' 


3 , 


Device Interrupt Timeout (HARD) 


E$SUNS= 


'B' 


4 


Device Unsolicited Interrupt 


E$STMS= 


'B' 


5 


Device Interrupt Timeout (SOFT) 


E$CDVI= 


'B' 


3 


• Device Information 


E$SDVI= 


B' 


1 


Device Information Message 


E$CDCI= 


'B' 


4 , 


Device Control Information 


E$SMOU= 


B' 


1 


Device Mount 


E$SDMO= 


'B' 


2 ; 


Device Dismount 


E$SRES= 


B' 


3 ; 


Device Count Reset 


E$SRCT= 


'B' 


4 ; 


Block Replacement 


E$CMEM= 


B' 


5 


Memory Detected Errors 


E$SMEM= 


'B' 


1 ; 


Memory Error 


E$CSYS= 


B ' 


6 ; 


System Control Information 


E$SPWR= 


'B' 


1 ; 


Power Recovery 
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E$CCTL= 


•B' 


7 


E$STIM= 


'B 1 


1 


E$SCRS= 


'B 1 


2 


E$SLOA= 


'B' 


3 


E$SUNL= 


'B' 


4 


E$SHRC= 


•B' 


5 


E$SMES= 


'B' 


6 


E$CCPU= 


•B' 


10 


E$SINT= 


•B' 


1 


E$CSDE= 


'B' 


11 


E$SABO= 


'B' 


1 


for Context 


EH$NOR= 


B' 


1 


EH$STA= 


'B 1 


2 


EH$CRS= 


B ' 


3 


for Flags 


en 


EH$VIR= 


•B' 


1 


EH$EXT= 


'B' 


2 


EH$COU= 


'B' 


4 


EH$QBS= 


•B' 


10 


EH$LMR= 


'B' 


20 



Control Information 
Time Change 
System Crash 
Device Driver Load 
Device Driver Unload 
Reconfiguration Status Change 
Message 

CPU Detected Errors 

Unexpected Interrupt 

Software Detected Events 
Task Abort 



Normal Entry 
Start Entry 
Crash Entry 



Addresses are virtual 
Addresses are extended 
Error counts supplied 
Q-BUS CPU 
Limit reached 



Task Subpacket 

+ + 

|^ Task Subpacket Length | 

| Task Name in RAD 50 | 

+ + 

| Task UIC | 
+ + 

| Task TI: Device Name | 
+ + + 

| Flags | Task TI : Unit Number | 
+ + + 



.=0 










E$TLGH : 


1 L ' 


. BLKW 


1 


; Task Subpacket Length 


E$TTSK: 


1 L 1 


. BLKW 


2 


; Task Name in RAD 50 


E$TUIC: 


1 L ' 


.BLKW 


1 


• Task UIC 


E$TTID : 


1 L ' 


. BLKB 


2 


• Task TI: Device Name 


E$TTIU: 


L 1 


.BLKB 


1 


Task TI: Unit 


E$TFLG: 


1 L ' 


.BLKB 


1 


; Flags 






.EVEN 






E*$TLEN: 


1 L ' 








; Flags 


for 


entry 


E$TFLG 





ET$PRV='B' 1 
ET$PRI= , B I 2 



; Task is Privileged 

; Terminal is Privileged 



B-9 



RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



EPKDF$ (Cont.) 

; Device Identification Subpacket 

; + + 

; | Device Identification Subpacket Length | 

; + + 

; | Device Mnemonic Name | 

; + + + 

; | Controller Number | Device Unit Number | 

; + + + 

; | Physical Subunit # | Physical Unit # | 

; + + + 

; | Physical Device Mnemonic (RSX-11M-PLUS only) | 
; + + + 

; | Reserved | Flags | 

; + + + 

; Volume Name of Mounted Volume 

; + + 

; Pack Identification 

; + + 

; j Device Type Class | 

; + + 

; Device Type 

; + + 

; I/O Operation Count Longword 

; + + + 

; | Hard Error Count | Soft Error Count | 

; + + + 

; Blocks Transferred Count (RSX-11M-PLUS only) 

; + + 

; Cylinders Crossed Count (RSX-11M-PLUS only) 

; + + 

.=0 

E$ILGH:'L' .BLKW 1 ; Device Identification Subpacke 

E$ILDV:'L' . BLKW 1 ; Device Mnemonic Name 

E$ILUN:'L' .BLKB 1 ; Device Unit Number 

E$IPCO:'L' .BLKB 1 ; Controller Number 

E$IPUN:'L' .BLKB 1 ; Physical Unit Number 

E$IPSU:'L I .BLKB 1 ; Physical Subunit Number 

.IF DF R$$MPL 

E$IPDV:'L' . BLKW 1 ; Physical Device Mnemonic 

. ENDC ; R$$MPL 
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i 

i 

. BLKB 12. 
.BLKB 4 



E$IFLG:'L' .BLKB 
.BLKB 

E$IVOL: ' L 
E$IPAK: ' L 
E$IDEV: 1 L 

E$IDCL:'L' .BLKW 

E$IDTY: 1 L ' .BLKW 

E$IOPR:'L' .BLKW 

E$IERS: 'L' .BLKB 

E$IERH : ' L 1 .BLKB 



Flags 

Reserved 

Volume Name • 

Pack Identification 

Device Type 

Device Type Class 

Device Type 

I/O Operation Count Longword 
Soft Error Count 
Hard Error Count 



.IF DF R$$MPL 



E$IBLK : 1 L ' .BLKW 



E$ICYL: 



.BLKW 

. ENDC 
. EVEN 



; Blocks transferred count 
; Cylinders crossed count 



R$$MPL 



E$ILEN: 1 L ' 



; Subpacket Length 
Flags for field E$IFLG 

EI$SUB='B' 1 ; Subcontroller device 

.IF DF R$$MPL 

EI$NUX='B' 2 ; No UCB extension, data invalid 

. ENDC ; R$$MPL 

Device Operation Subpacket 

+ 



Device Operation Subpacket Length 



Task Name in RAD 50 



Task UIC 



| Task TI: Logical Device Mnemonic | 
+ + + 

| Reserved | Task TI : Device Unit | 



I/O Function Code 



Reserved 



Operation Flags 



+ + 

Transfer Operation Address 



Transfer Operation Byte Count 



Current Operation Retry Count 



= 
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E$OLGN : ' L 1 . BLKW 1 ; Subpacket Length 

E$OTSK:'L' .BLKW 2 ; Task Name in RAD 50 



. EVEN 

E$OLEN : ' L 1 ; Device Operation Subpacket Length 

; Flags for field E$OFLG 

EO$TRA= , B l 1 ; Transfer Operation 

EO$DMA= 1 B ' 2 ; DMA Device 

EO$EXT='B' 4 ; Extended Addressing Device 

EO$PIP='B' 10 ; Device is positioning 

; I/O Activity Subpacket 

; + + 

; | I/O Activity Subpacket Length | 

; + + 

.=0 

E$ALGH : 1 L ' .BLKW 1 ; Subpacket Length 

; I/O Activity Subpacket Entry 

; + + 

; | Logical Device Name Mnemonic | 
; + + + 

; | Controller Number | Logical Device Unit | 
; + + + 

; | Physical Subunit # | Physical Unit Number | 
; + + + 

; | Physical Device Mnemonic (RSX-11M-PLUS only) | 
; + + + 

; | Task TI : logical unit | Device flags | 
; + + + 

; Requesting Task Name in RAD 50 

; + + 

; | Requesting Task UIC | 

; + + 

; | Task TI: Logical Device Name | 

; + + 

; | I/O Function Code | 
■ + + + 

(Continued on next page) 
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Reserved 




| Flags 

+ 


Transfer 


Operation 


Address 


Transfer 


Operation 


Byte Count 



.=0 



Logical Device Name Mnemonic 
Logical Device Unit 
Controller Number 
Physical Unit Number 
Physical Subunit Number 



IF DF R$$MPL 

; Physical Device Mnemonic 



Device flags 

Task TI : Logical Unit 

Requesting Task Name in RAD 50 

Requesting Task UIC 

Task TI: Logical Device Name 

I/O Function Code 

Flags 

Reserved 

Transfer Operation Address 
Transfer Operation Byte Count 



E$ALEN : 1 L 1 ; Subpacket Entry Length 

Flags for field E$ADFG 

EA$SUB='B' 1 ; Subcontroller device 

. IF DF R$$MPL 
EA$NUX='B' 2 ; No UCB extension, data invalid 

. ENDC ; R$$MPL 
Flags for field E$AFLG 



E$ALDV: 


'L' 


.BLKW 


1 


E$ALUN: 


'L' 


. BLKB 


1 


E$APCO: 


'L ' 


.BLKB 


1 


E$APUN: 


'L' 


.BLKB 


1 


E$APSU: 


'L' 


• BLKB 


1 






. IF 


E$APDV: 


'L' 


.BLKW 


1 






.ENDC 




E$ADFG: 


'L' 


.BLKB 


1 


E$ATIU: 


! L' 


.BLKB 


1 


E$ATSK: 


'L' 


.BLKW 


2 


E$AUIC: 


'L' 


.BLKW 


1 


E$ATID: 


'L' 


.BLKW 


1 


E$AFNC: 


'L' 


.BLKW 


1 


E$AFLG: 


'L' 


.BLKB 


1 






.BLKB 


1 


E$AADD: 


'L' 


.BLKW 


2 


E$ASIZ: 


*L' 


.BLKW 


1 






.EVEN 





EA$TRA= 'B 1 1 

EA$DMA= *B ' 2 

EA$EXT= ' B ' 4 

EA$PIP='B' 10 

.PSECT 



; Transfer Operation 
; , DMA Device 

; Device has Extended Addressing 
; Device is positioning 



.MACRO EPKDF$ X,Y 
. ENDM 



. ENDM 
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. MACRO EVNDF$,L,B,LST 



EVNDF$ — Event Packet Definitions 

This module contains a macro which defines the offsets and field 
values for TSA Event Packets (TEP's). These packets are used to 
pass data and status information between system components that 
provide Digital's Terminal Software Architecture support on RSX. 



Explicit Inputs: 

L 
B 

LST 

Implicit Inputs: 
NONE 



":" for global offset definitions 
"=" for global bit/value definitions 
"LIST" for macro expansion listing 



Outputs : 



Symbols defined as described above. 
Listing as described above. 



General packet header format 

. ASECT 
.=0 



; Define offsets absolutely 



E. VLNK: 'L ' 
E.VSIZ: 'L' 
E . VTYP : 'L ' 
E . VUCB : ' L • 



.BLKW 1 
, BLKB 1 
, BLKB 1 
, BLKW 1 



Link word 
Packet size 
Packet type 
Terminal UCB address 



E.VTYP Values 



ET.LOW='B '0 



ET.QIO= 
ET.BND= 
ET.UNB= 
ET.BCP= 
ET.REJ = 
ET.DIS= 
ET.DCP = 
ET. ICS = 
ET.OOB = 
ET.ONO= 
ET.PHO: 



'B'O 

'B'2 

'B'4 

'B'6 

'B'10 

'B'12 

•B'14 

'B'16 

•B'20 

'B'22 

'B'24 



ET.HI='B '24 



Lowest valid type code 

QIO (distinguishes QIO packet from TEP) 
Bind Request 
Unbind Request 
Bind Complete 
Bind Reject 

Disconnect Notification 

Disconnect Complete 

Input Count State Change 

Out-of-Band (OOB) 

Abnormal Termination Request 

Physical Terminal Disconnected 

Highest valid type code 
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The following definitions are for packet types that require 
passing additional information in the packets. All other packet 
types use the general packet format described above. 



Bind Request packet (Terminal Management Mode — > Network) 
. =E. VUCB+2 



E . VBCT : ' L 1 
E . VBND : 'L 1 
E.VBLN: ' L ' 



•BLKW 1 ; Count of nodes (One for now) 
•BLKB 6 ; Node name 

; Length of bind request 



Input Count State Change, Out-Of-Band packets (TTDRV — > Network) 
And Modem Hang-up packets (TSA... — > Network) 



. =E. VUCB+2 



E.VAPR: 'L' 
E . VADR: 'L' 
E.VFLG: ' L ' 



.BLKW 1 ; Doubleword address of packet, 
.BLKW 1 ; ...queueing routine 
.BLKW 1 ; Flag 



Input Count State Change 
.=E.VFLG+2 

E.VSLN: 'L 1 



; Length of Input state message 



00B 



.=E.VFLG+2 



E . VOBM : 1 L 1 
E.VHDR: 'L' 
E . VTAB : 1 L ' 
E.VOLN: 'L' 



•BLKW 6 ; Out-of-Band bitmasks 
.BLKW 2 ; Type-ahead buffer header 
.BLKB 10. ; Type-ahead buffer 
; Length of OOB packet 



Terminal Management Switch Characters 
.=E.VFLG+2 



E . VSWC : 1 L ' 
E.VTLN: 'L ' 



.BLKW 1 ; Terminal management switch characters 
; Length of Switch Character packet 



Bit values in flag word (E.VFLG) . For convenience some bits have 

corresponding bits in the AST Control Block flag word (A.PRM+5) 



EF.NCO= , B*l 

EF.NOI='B'2 

EF.AST='B'10 

EF.LCK='B'40 

EF . QUE= 'B ' 100 

EF.MDE='B'200 



All non-control characters are out-of band 

All non-control OOB are include-OOB 

Reserved bit synonymous with TF.AST 

Reserved bit synonymous with AF.LCK 

TEP is queued 

TEP is marked for delete 
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EVNDFS (Cont.) 



Unbind Request packet (TMM — > Network) 
. =E. VUCB+2 

E. VULN: 'L * ; Length of Unbind message 

Connect Reject notification packet (Network — > TMM) 
. =E. VUCB+2 

E.VRR:'L' .BLKW 1 ; Reason for Rejection 

E . VRLN: ' L ' ; Length of Reject message 

Disconnect Notification packet (Network — > TMM) 
. =E. VUCB+2 

E.VRD:'L' .BLKW 1 ; Reason for Disconnect 

E.VDLN:'L' ; Length of Disconnect message 

Disconnect Complete packet (TMM — > Network) 
,=E. VUCB+2 

E.VDCL:*L' ; Length of Disconnect Complete message 

. PSECT 

.IF NB LST 

. NLIST ; Turn listing back off 

. IFF 

.MACRO EVNDF$ ; If not listing, redefine 

. ENDM ; macro to nothing 

. ENDC 

.ENDM EVNDF$ 
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F1 1 DF$ 



. MACRO F11DF$,L,B 



VOLUME CONTROL BLOCK 



. ASECT 



.=0 



V. TRCT : 


'L 


' .BLKW 


1 




V . 1 IF£j . 


•L 


' . BLKB 


1 






VT 


.FOR='B 


t 







VT 


.SL1= 'B 


i 


1 




VT.SL2='B 


• 


2 




VT 


.ANS='B 


• 10 




VT 


,UNL='B 


' 11 


\7 t./C'ha • 
v • vv^rifi . 


'L 


' .BLKB 


1 






VC 


.SLK='B 


i 


1 




VC 


.HLK= 'B 


• 


2 




VC.DEA='B 


t 


4 




VC 


. PUB= *B 


• 


10 




VC 


.DUP='B 


' 20 


v r ARr • 

V • LittDlj • 


'L 


' .BLKB 


14 




\T D7CD • 


'L 


1 .BLKW 


2 




V. SLEN : 


'L 


i 






v . I fw I : 


'L 


' .BLKW 


1 




V.FCB: ' 


L' 


.BLKW 


2 




V. IBLB: 


•L 


' .BLKB 


1 




V. IBSZ : 


'L 


' .BLKB 


1 






.BLKW 


1 




V.FMAX: 


'L 


1 .BLKW 


1 




V.WISZ : 


•L 


■ .BLKB 


1 




V. SBCL : 


•L 


' .BLKB 


1 




V. SBSZ : 


'L 


1 .BLKW 


1 




V.SBLB: 


•L 


1 .BLKB 


1 




V.FIEX: 


•L 


' .BLKB 


1 








.BLKW 


1 




V.VOWN: 


'L 


' .BLKW 


1 




V.VPRO: 


'L 


' .BLKW 


1 




V.FPRO: 


'L 


' .BLKW 


1 




V.FRBK: 


•L 


' .BLKB 


1 




V.LRUC: 


•L 


' .BLKB 


1 








.BLKW 


1 




V.STS: 1 


L' 


.BLKB 


1 






VS 


. IFW= 'B 


'1 






VS 


.BMW='B 


'2 




V.FFNU: 


•L 


1 .BLKB 


1 




V. EXT: ' 


L' 


.BLKW 


1 




V.HBLB: 


■L 


' .BLKW 


2 




V.HBCS: 


'L 


' .BLKW 


2 




V.LGTH: 


•L 


i 







TRANSACTION COUNT 

VOLUME TYPE DESCRIPTOR 
; Foreign volume structure 
; Files-11 Structure level 1 
; Files-11 Structure level 2 
; ANSI labeled tape 
; Unlabeled tape 

Volume characteristics 
; Clear volume valid on dismount 
; Unload the volume on dismount 
; Deallocate the volume on dismount 
; Set (clear) US. PUB on dismount 
; Duplicate volume name; don't delete 
; logicals 

Volume label (ASCII) 

Pack serial number for error logging 

Length of short VCB 

INDEX FILE WINDOW 

FILE CONTROL BLOCK LIST HEAD 

INDEX BIT MAP 1ST LBN HIGH BYTE 

INDEX BIT MAP SIZE IN BLOCKS 

INDEX BITMAP 1ST LBN LOW BITS 

MAX NO. OF FILES ON VOLUME 

DEFAULT SIZE OF WINDOW IN RTRV PTRS 

VALUE IS < 128. 

STORAGE BIT MAP CLUSTER FACTOR 

STORAGE BIT MAP SIZE IN BLOCKS 

STORAGE BIT MAP 1ST LBN HIGH BYTE 

DEFAULT FILE EXTEND SIZE 

STORAGE BIT MAP 1ST LBN LOW BITS 

VOLUME OWNER'S UIC 

VOLUME PROTECTION 

VOLUME DEFAULT FILE PROTECTION 

NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE 

COUNT OF AVAILABLE LRU SLOTS IN FCB LIST 

NUMBER OF FREE BLOCKS ON VOLUME LOW BITS 

VOLUME STATUS BYTE, CONTAINING THE 

FOLLOWING 

INDEX FILE IS WRITE ACCESSED 

STORAGE BITMAP FILE IS WRITE ACCESSED 

FIRST FREE INDEX FILE BITMAP BLOCK 

POINTER TO VCB EXTENSION 

LBN of home block 

Home block checksums 

SIZE IN BYTES OF VCB 
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F11DF$ (Cont.) 



MOUNT LIST ENTRY 

EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUBLIC DEVICE 

TO ALLOW EXPANSION, ONLY THE ONLY TYPE CODE DEFINED IS "1" FOR 
DEVICE ACCESS BLOCKS 



.ASECT 



.=0 



M . LNK : ' L ' .BLKW 1 

M . TYPE : 'L * .BLKB 1 

MT ,MLS = 1 B 1 1 

M.ACC: 1 L ' .BLKB 1 

M.DEV: 'L 1 .BLKW 1 

M.TI : 'L • .BLKW 1 
M.LEN: 'L ' 



LINK WORD 
TYPE OF ENTRY 

: Mounted volume user access list 
NUMBER OF ACCESSES 
DEVICE UCB 
ACCESSOR TI : UCB 
LENGTH OF ENTRY 



; FILE CONTROL BLOCK 



.ASECT 



.=0 

F . LINK : 
F.FNUM: 
F.FSEQ: 

F.FSQN 
F . FOWN 
F.FPRO 
F.UCHA 
F.SCHA 
F . HDLB 



L ' .BLKW 
L 1 .BLKW 
L 1 .BLKW 
.BLKB 
L ' .BLKB 
L 1 .BLKW 
L 1 .BLKW 
L 1 .BLKB 
L 1 .BLKB 
L 1 .BLKW 



F.LBN: 'L' .BLKW 



SIZE: 
NACS: 
NLCK: 



'L' .BLKW 
'L ' .BLKB 
'L' .BLKB 



S.STBK='B' .-F.LBN 

F.STAT: 'L 1 

F.NWAC: 'L' .BLKB 1 
.BLKB 1 
FC.WAC= , B' 100000 
FC.DIR='B' 40000 
FC.CEF= I B' 20000 
FC.FCO='B' 10000 

F.DREF: 'L ' .BLKW 1 

F.DRNM: 'L' .BLKW 1 

F.FEXT: 'L ' .BLKW 1 

F.FVBN: 'L' .BLKW 2 

F . LKL : 1 L ' .BLKW 1 

F.WIN: 'L' .BLKW 1 

F.LGTH: 'L ' 



FCB CHAIN POINTER 
FILE NUMBER 
FILE SEQUENCE NUMBER 
NOT USED 

FILE SEGMENT NUMBER 

FILE OWNER'S UIC 

FILE PROTECTION CODE 

USER CONTROLLED CHARACTERISTICS 

SYSTEM CONTROLLED CHARACTERISTICS 

FILE HEADER LOGICAL BLOCK NUMBER 

BEGINNING OF STATISTICS BLOCK 

LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS 

IF NON CONTIGUOUS 

SIZE OF FILE IN BLOCKS 

NO. OF ACCESSES 

NO. OF LOCKS 

SIZE OF STATISTICS BLOCK 

FCB STATUS WORD 
NUMBER OF WRITE ACCESSORS 
STATUS BITS FOR FCB CONSISTING OF 
SET IF FILE ACCESSED FOR WRITE 
SET IF FCB IS IN DIRECTORY LRU 
SET IF DIRECTORY EOF NEEDS UPDATING 
SET IF TRYING TO FORCE DIRECTORY CONTIG 
DIRECTORY EOF BLOCK NUMBER 
1ST WORD OF DIRECTORY NAME 
POINTER TO EXTENSION FCB 
STARTING VBN OF THIS FILE SEGMENT 
POINTER TO LOCKED BLOCK LIST FOR FILE 
WINDOW BLOCK LIST FOR THIS FILE 
SIZE IN BYTES OF FCB 
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WINDOW 



= 



.ASECT 



W.ACT: 'L 



W.BLKS: 'L 



W.CTL: 1 L ' .BLKW 



WI 
WI 
WI 
WI 
WI 
WI 
WI 
WI 

W. IOC: "L ' 

W . FCB : " L 1 
W.TCB: 'L 1 
W.UCB: 'L' 
W.LKL: 'L' 
W.WIN: 1 L 1 



.RDV='B' 
,WRV= 'B 1 
.EXT= 'B ' 
. LCK= 'B ' 
,DLK = 'B ' 
. PND= 'B' 
.EXL='B * 
.WCK='B' 
.BLKB 1 
.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 



400 

1000 

2000 

4000 

10000 

20000 

40000 

100000 



NUMBER OF ACTIVE MAPPING POINTERS 

WHEN NO SECONDARY POOL 
BLOCK SIZE OF SECONDARY POOL SEGMENT 

WHEN SECONDARY POOL 
LOW BYTE = # OF MAP ENTRIES ACTIVE 
HIGH BYTE CONSISTS OF CONTROL BITS 
READ VIRTUAL BLOCK ALLOWED IF SET 
WRITE VIRTUAL BLOCK ALLOWED IF SET 
EXTEND ALLOWED IF SET 

SET IF LOCKED AGAINST SHARED ACCESS 

SET IF DEACCESS LOCK ENABLED 

WINDOW TURN PENDING BIT 

SET IF MANUAL UNLOCK DESIRED 

Data check all writes to file 

COUNT OF I/O THROUGH THIS WINDOW 

Reserved 

FILE CONTROL BLOCK ADDRESS 
TCB address of accessor 
Original UCB address of device 
POINTER TO LIST OF USERS LOCKED BLOCKS 
WINDOW BLOCK LIST LINK WORD 



.IF 
. IF 



NB , SYSDEF ; IF SYSDEF SPECIFIED IN CALL 
NDF,P$$WND ; IF SECONDARY POOL WINDOWS NOT ALLOWED 



NON-SECONDARY POOL WINDOW BLOCK 

IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK 
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS. 



W.VBN:'L f .BLKB 1 
W.MAP: 'L' 

W.WISZ: 'L' .BLKB 1 
.BLKW 1 

W.RTRV: 'L' 
W.SLEN='B'-4 



.IFF 



HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD 
REFS 

SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

Dummy definition to prevent incorrect 
reference 

(-4 when rounded "up" is a VERY large block) 
IF WINDOWS IN SECONDARY POOL 



SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS 
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE 
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION 
FOR THE SECONDARY POOL WINDOW. 
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W.MAPr'L 1 .BLKW 1 
W.SLEN: 'L' 



ADDR TO THE MAPPING PTRS IN SECONDARY POOL 
Length of primary pool stub 



SECONDARY POOL WINDOW 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL 
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING 
FORMAT . 



.=0 



ASSUME 



.BLKB 

W.USE:'L' .BLKB 
W.VBNr'L' .BLKB 
W.WISZ: 'L' .BLKB 
.BLKW 

W.RTRV: 'L' 

. ENDC 
. ENDC 



W.CTL,0 



NUMBER OF ACTIVE MAPPING POINTERS 
STATUS OF BLOCK 

HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
SIZE IN RTRV PTRS OF WINDOW (7 BITS) 
LOW ORDER WORD OF 1ST VBN MAPPED 
OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

; END SECONDARY POOL WINDOW CONDITIONAL 

; END SYSDEF CONDITIONAL 



LOCKED BLOCK LIST NODE 



.ASECT 



.=0 



L.LNK: 


'L' 


.BLKW 


1 


; LINK TO NEXT NODE IN LIST 


L.WI1: 


'L' 


.BLKW 


1 


; POINTER TO WINDOW FOR FIRST 


L. VB1: 


•L* 


.BLKB 


1 


; HIGH ORDER VBN BYTE 


L.CNT: 


•L' 


.BLKB 


1 


; COUNT FOR ENTRY 






.BLKW 


1 


; LOW ORDER VBN 


L.LKSZ 


: 'L 


• 






; END 


OF 


DEFINITIONS 





.PSECT 

.MACRO F11DF$ 

. ENDM F11DF$ 

. ENDM F11DF$ 



X,Y,Z 
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HDRDFS 



.MACRO HDRDF$,L,B 



+ 

TASK HEADER OFFSET DEFINITIONS 



.ASECT 



.=0 










H.CSP: ■ 


L* 


.BLKW 


1 


;CURRENT STACK POINTER 


H.HDLN: 


■L' 


.BLKW 


1 


; HEADER LENGTH IN BYTES 


H.EFLM: 


•L 


.BLKW 


2 


; EVENT FLAG MASK WORD AND ADDRESS 


H.CUIC: 


'L' 


.BLKW 


1 


;CURRENT TASK UIC 


H.DUIC: 


' L 1 


.BLKW 


1 


; DEFAULT TASK UIC 


H. IPS: 1 L ' 


.BLKW 


1 


; INITIAL PROCESSOR STATUS WORD (PS) 


H . I PC : ' 


L 1 


.BLKW 


1 


; INITIAL PROGRAM COUNTER (PC) 


H.ISP: ' 


L ' 


.BLKW 


1 


; INITIAL STACK POINTER (SP) 


H . ODVA : 


•L 1 


.BLKW 


1 


;ODT SST VECTOR ADDRESS 


H.ODVL: 


1 L 1 


.BLKW 


1 


;ODT SST VECTOR LENGTH 


H . TKVA : 


'L' 


.BLKW 


1 


; TASK SST VECTOR ADDRESS 


H.TKVL: 


*L ' 


.BLKW 


1 


; TASK SST VECTOR LENGTH 


H.PFVA: 


1 L 1 


.BLKW 


1 


; POWER FAIL AST CONTROL BLOCK ADDRESS 


H.FPVA: 


' L 1 


.BLKW 


1 


;FLOATING POINT AST CONTROL BLOCK ADDRESS 


H.RCVA: 


•L' 


.BLKW 


1 


;RECIEVE AST CONTROL BLOCK ADDRESS 


H.EFSV: 


'L' 


.BLKW 


1 


; EVENT FLAG ADDRESS SAVE ADDRESS 


H.FPSA: 


' L 1 


.BLKW 


1 


; POINTER TO FLOATING POINT/EAE SAVE AREA 


H.WND: 1 


L ' 


.BLKW 


1 


; POINTER TO NUMBER OF WINDOW BLOCKS 


H.DSW: ' 


L * 


.BLKW 


1 


; TASK DIRECTIVE STATUS WORD 


H.FCS: ' 


L ' 


.BLKW 


1 


;FCS IMPURE POINTER 


H.FORT: 


1 L 1 


.BLKW 


1 


; FORTRAN IMPURE POINTER 


H.OVLY: 


1 L 1 


.BLKW 


1 


; OVERLAY IMPURE POINTER 


H. VEXT: 


'L' 


.BLKW 


1 


;WORK AREA EXTENSION VECTOR POINTER 


H.SPRI : 


1 L ' 


.BLKB 


1 


; PRIORITY DIFFERENCE FOR SWAPPING 


H.NML: ' 


L' 


.BLKB 


1 


; NETWORK MAILBOX LUN 


H . RRVA : 


1 L 1 


.BLKW 


1 


;RECEIVE BY REFERENCE AST CONTROL BLOCK 










; ADDRESS 


H.X25: ' 


L 1 


.BLKB 


1 


; FOR USE BY X.25 SOFTWARE 






.BLKB 


1 


; FIVE RESERVED BYTES 






.BLKW 


2 




H . GARD : 


' L 


.BLKW 


1 


; POINTER TO HEADER GUARD WORD 


H.NLUN: 


1 L 1 


.BLKW 


1 


; NUMBER OF LUN ' S 


H.LUN: ' 


L ' 


.BLKW 


2 


; START OF LOGICAL UNIT TABLE 



; + 

; LENGTH OF FLOATING POINT SAVE AREA 

H.FPSL='B'25.*2 
; + 

; WINDOW BLOCK OFFSETS 



.=0 

W.BPCB: 'L ■ .BLKW 1 

W.BLVR: 'L' .BLKW 1 

W.BHVR: 'L' .BLKW 1 

W.BATT: 'L' .BLKW 1 

W.BSIZ: 'L' .BLKW 1 



; PARTITION CONTROL BLOCK ADDRESS 
;LOW VIRTUAL ADDRESS LIMIT 
;HIGH VIRTUAL ADDRESS LIMIT 
; ADDRESS OF ATTACHMENT DESCRIPTOR 
;SIZE OF WINDOW IN 32W BLOCKS 
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W.BOFF: 1 L 1 . BLKW 1 

W.BFPD: 'L' .BLKB 1 

W.BNPD: ' L 1 .BLKB 1 

W.BLPD: 'L ' .BLKW 1 
W.BLGH: 1 L ' 



; PHYSICAL MEMORY OFFSET IN 32W BLOCKS 

; FIRST PDR ADDRESS 

; NUMBER OF PDR 1 S TO MAP 

;CONTENTS OF LAST PDR 

; LENGTH OF WINDOW DESCRIPTOR 



.PSECT 

.MACRO HDRDF$ X,Y 
. ENDM 
. ENDM 
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HWDDFS 



. MACRO HWDDF$,L,B 

+ 

HARDWARE REGISTER ADDRESSES AND STATUS CODES 



MPCSR='B' 177746 ; ADDRESS OF PDP-11/70 MEMORY 

; PARITY REGISTER 

MPAR= 'B ' 172100 ; ADDRESS OF FIRST MEMORY 

; PARITY REGISTER 

PIRQ='B' 177772 ; PROGRAMMED INTERRUPT REQUEST 

REGISTER 

PROCESSOR PRIORITY 
PROCESSOR PRIORITY 1 
PROCESSOR PRIORITY 4 
PROCESSOR PRIORITY 5 
PROCESSOR PRIORITY 6 
PROCESSOR PRIORITY 7 
PROCESSOR STATUS WORD 
CONSOLE SWITCH AND DISPLAY 
REGISTER 

TPS='B' 177564 ;CONSOLE TERMINAL PRINTER STATUS 

; REGISTER 

; + 

; EXTENDED ARITHMETIC ELEMENT REGISTERS 



PR0='B' 

PR1='B' 40 

PR4='B' 200 

PR5='B' 240 

PR6='B' 300 

PR7='B' 340 

PS='B» 177776 

SWR='B' 177570 



.IF DF E$$EAE 

ACCUMULATOR 
; MULTIPLIER -QUOTIENT 
;SHIFT COUNT 

. ENDC 



AC='B' 177302 
MQ= 'B ' 177304 
SC='B' 177310 



+ 

MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES 



.IF DF M$$MGE 



KDSAR0= 


•B' 


172360 


; KERNEL 


D 


PAR 





KDSDR0= 


'B' 


172320 


•KERNEL 


D 


PDR 





KISAR0= 


'B' 


172340 


KERNEL 


I 


PAR 





KINAR0= 


'B' 


KISAR0 , 


KERNEL 


I 


PAR 





KISAR5= 


'B' 


172352 


; KERNEL 


I 


PAR 


5 


KINAR5= 


•B' 


KISAR5 , 


KERNEL 


I 


PAR 


5 


KISAR6= 


'B' 


172354 


; KERNEL 


I 


PAR 


6 


KINAR6= 


•B' 


KISAR6 , 


KERNEL 


I 


PAR 


6 


KISAR7= 


•B 1 


172356 


; KERNEL 


I 


PAR 


7 


KINAR7= 


'B' 


KISAR7 J 


KERNEL 


I 


PAR 


7 


KISDR0= 


'B' 


172300 


•KERNEL 


I 


PDR 





KISDR6= 


'B 1 


172314 , 


KERNEL 


I 


PDR 


6 
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KISDR7= ' 


B 1 


172316 


; KERNEL 


I PAR 


7 


SISDR0=' 


B • 


172200 


SUPERVISOR 


I 


PDR 


UDSAR0= ' 


B 1 


177660 


?USER 


D 


PAR 







UDSDR0= 1 


B 1 


177620 


, USER 


D 


PDR 







UISAR0= 1 


B ' 


177640 


;USER 


I 


PAR 







UISAR4=' 


B ' 


177650 , 


USER 


I 


PAR 


4 




UISAR5= ' 


B' 


177652 


; USER 


I 


PAR 


5 




UISAR6=* 


B' 


177654 


USER 


I 


PAR 


6 




UISAR7= ' 


B' 


177656 


;USER 


I 


PAR 


7 




UISDR0=' 


B' 


177600 


USER 


I 


PDR 







UISDR4= • 


B' 


177610 


, USER 


I 


PDR 


4 




UISDR5=' 


B' 


177612 


USER 


I 


PDR 


5 




UISDR6= 1 


B' 


177614 


USER 


I 


PDR 


6 




UISDR7=' 


B' 


177616 


USER 


I 


PDR 


7 




UBMPR='B' 


170200 


UNIBUS 


MAPPING REGISTER 


CMODE='B 1 


140000 , 


CURRENT 


MODE 


FIELD OF PS WORD 



. IFTF 
PMODE= 'B 1 



IFT 



SR0='B' 
SR3= 'B' 



;M$$MGE 

30000 

;M$$MGE 

177572 
172516 



; PREVIOUS MODE FIELD OF PS WORD 



; SEGMENT STATUS REGISTER 
; SEGMENT STATUS REGISTER 3 



. ENDC 



+ 

FEATURE SYMBOL DEFINITIONS 



FE 


.EXT = 


'B' 


1 


; 22-BIT EXTENDED MEMORY SUPPORT 


FE 


.MUP = 


'B' 


2 


;MULTI-USER PROTECTION SUPPORT 


FE 


. EXV= 


'B' 


4 


EXECUTIVE IS SUPPORTED TO 20K 


FE 


.DRV= 


'B' 


10 


; LOADABLE DRIVER SUPPORT 


FE 


.PLA = 


'B' 


20 


;PLAS SUPPORT 


FE 


.CAL = 


•B' 


40 


; DYNAMIC CHECKPOINT SPACE ALLOCATION 


FE 


,PKT = 


'B' 


100 


; PREALLOCATION OF I/O PACKETS 


FE 


.EXP = 


•B' 


200 


; EXTEND TASK DIRECTIVE SUPPORTED 


FE 


.LSI = 


•B' 


400 


;PROCESSOR IS AN LSI-11 


FE 


.OFF = 


'B' 


1000 


; PARENT OFFSPRING TASKING SUPPORTED 


FE 


. FDT = 


•B • 


2000 


; FULL DUPLEX TERMINAL DRIVER 


FE 


. X25 = 


'B' 


4000 


;X.25 COM EXECUTIVE LOADED (1=YES) 


FE 


. DYM = 


'B' 


10000 


; DYNAMIC MEMORY ALLOCATION SUPPORTED 


FE 


.CEX= 


■B' 


20000 


;COM EXEC IS LOADED 


FE 


.MXT = 


'B ' 


40000 


;MCR EXIT AFTER EACH COMMAND MODE 


FE 


. NLG = 


■B' 


100000 


; LOGINS DISABLED - MULTI-USER SUPPORT 



+ 

SECOND FEATURE MASK SYMBOL DEFINITIONS 



F2.DAS='B' 1 ; KERNEL DATA SPACE (M-PLUS ONLY) 

F2.LIB='B' 2 SUPERVISOR MODE LIBRARIES 

F2.MP= , B' 4 MULTIPROCESSING SUPPORT 
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F2 


. EVT = 


'B 1 


10 


; EVENT TRACE SUPPORT 


F2 


. ACN = 


'B' 


20 


•CPU ACCOUNTING 


F2 


.SDW= 


'B' 


40 


[SHADOW RECORDING 


F2 


. POL = 


•B 1 


100 , 


SECONDARY POOLS 


F2 


,WND = 


■B' 


200 


[SECONDARY POOL FILE WINDOWS 


F2 


. DPR = 


'B' 


400 


DIRECTIVE PARTITION SUPPORT 


F2 


. IRR= 


'B' 


1000 


INSTALL, REQUEST AND REMOVE SUPPORT 


F2 


. GGF = 


'B 1 


2000 ; 


GROUP GLOBAL EVENT FLAG SUPPORT 


F2 


. RAS = 


'B' 


4000 


[RECEIVE/SEND DATA PACKET SUPPORT 


F2 


. AHR = 


•B' 


10000 


ALT. HEADER REFRESH AREAS SUPPORTED 


F2 


. RBN = 


'B' 


20000 


;ROUND ROBIN SCHEDULING SUPPORT 


F2 


. SWP = 


'B' 


40000 ; 


EXECUTIVE LEVEL DISK SWAPPING SUPPORT 


F2 


.STP = 


•B ' 


100000 


•EVENT FLAG MASK IS IN THE TCB (1=YES) 



+ 

THIRD FEATURE MASK SYMBOL DEFINITIONS 



F3. 


CRA= 


'B' 


1 ; 


SPONTANEOUS CRASH (1=YES) 


F3. 


NWK = 


•B* 


2 


•SYSTEM HAS NETWORK SUPPORT 


F3. 


EIS = 


•B« 


4 ; 


SYSTEM REQUIRES THE EXTENDED INST. SET 


F3. 


STM = 


• B i 


10 


[SYSTEM HAS SET SYSTEM TIME DIRECTIVE 


F3. 


UDS = 


IQI 


20 ; 


USER DATA SPACE (M-PLUS 


ONLY) 


F3. 


PRO= 




40 


PROTO TCBS OUT OF POOL 


ii 


F3. 


XHR= 


Igl 


100 ; 


EXTERNAL HEADER SUPPORT 


ii 


F3. 


AST = 


•B' 


200 


[SYSTEM HAS AST SUPPORT 




F3. 


11S = 


i B i 


400 ; 


SYSTEM IS RSX-11S 




F3. 


CLI = 


■B' 


1000 


[SYSTEM HAS MULTIPLE CLI 


SUPPORT 


F3. 


TCM= 


*B' 


2000 


TERMINAL COMMON (M-PLUS 


ONLY) 


F3. 


PMN= 


•B' 


4000 


POOL MONITORING SUPPORT 




F3. 


WAT = 


'B' 


10000 ; 


WATCHDOG TIMER SUPPORT 




F3. 


RLK= 


'B ' 


20000 


'RMS 1 RECORD LOCKING SUPPORT 


F3. 


SHF = 


•B' 


40000 , 


MEMORY SHUFFLER SUPPORTED 


;F3 


.RES 


= 'B' 


100000 


[RESERVED FOR FUTURE EXPANSION OF 11M 



; HARDWARE FEATURE MASK SYMBOL DEFINITIONS 



HF 


.UBM='B' 


1 


; SYSTEM 


HF 


.EIS= 'B ' 


2 


; SYSTEM 


HF 


. QB = 1 B ' 


4 


; SYSTEM 


HF 


.CIS= , B' 


200 


; SYSTEM 


HF 


.FPP='B' 


100000 


; SYSTEM 



HAS A UNIBUS MAP (1=YES) 
HAS EXTENDED INSTRUCTION SET 
HAS A QBUS BACKPLANE (1=YES) 
HAS COMMERCIAL INSTRUCTION SET 
SUPPORTS FLOATING POINT (l=NO) 



.MACRO HWDDF$ X,Y 
. EN DM 
. EN DM 
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.MACRO ITBDF$ L,B 
INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS 

.IF DF A$$TRP 
PKTDF$ 



.MCALL 

PKTDF$ 

. ENDC 

.ASECT 
.=0 

X. LNK : ' L 1 .BLKW 
X. JSR: 'L' JSR 
X.PSWr'L 1 .BLKB 
. BLKB 

X.ISR:'L' .BLKW 
X.FORK: 'L' 

.BLKW 
.BLKW 
.BLKW 
.BLKW 



R5,(§#0 

1 

1 

1 

1 
1 
1 
1 



.IF DF M$$MGE 
X . REL : 1 L ' .BLKW 1 
.ENDC 



X.DSIr'L 1 .BLKW 
X.TCB: ' L 1 .BLKW 

. IF NB 

.IF DF 

.BLKW 

X.ASTr'L 1 .BLKB 
.ENDC 

X.VECr'L' .BLKW 



X.VPC:'L' .BLKW 1 
X.LEN: 'L' 

.ENDC 



1 
1 

SYSDEF 
A$$TRP 
1 

A.PRM 



; DEFINE AST BLOCK OFFSETS 



LINK WORD FOR ITB LIST STARTING IN TCB 
CALL $INTSC 

LOW BYTE OF PSW FOR ISR 
UNUSED 

ISR ENTRY POINT (APR5 MAPPING) 

FORK BLOCK 

THREAD WORD 

FORK PC 

SAVED R5 

SAVED R4 



; RELOCATION BASE FOR APR5 



ADDRESS OF DIS.INT. ROUTINE 
TCB ADDRESS OF OWNING TASK 



A.DQSR FOR AST BLOCK 
AST BLOCK 



VECTOR ADDRESS (IF AST SUPPORT, 
THIS IS FIRST AND ONLY AST 
PARAMETER) 
SAVED VECTOR PC 
LENGTH IN BYTES OF ITB 



•PSECT 

.MACRO ITBDF$ 

. ENDM ITBDF$ 

. ENDM ITBDF$ 



X,Y,Z 
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.MACRO LCBDF$,L,B 



+ 



LOGICAL ASSIGNMENT CONTROL BLOCK 

THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO ASSOCIATE A 
LOGICAL NAME WITH A PHYSICAL DEVICE UNIT. LCB ' S ARE LINKED TOGETHER 
TO FORM THE LOGICAL ASSIGNMENTS OF A SYSTEM. ASSIGNMENTS MAY BE ON 
A SYSTEM WIDE OR LOCAL (TERMINAL) BASIS. 



.ASECT 



• — u 

L.LNK: 'L 1 
L . NAM : 1 L 1 
L.UNIT: *L' 
L . TYPE : 'L* 
L . UCB : ' L ' 
L.ASG: 'L' 
L.LGTH='B' 



= 



. BLKW 1 
. BLKW 1 
.BLKB 1 
. BLKB 1 
.BLKW 1 
.BLKW 1 
.-L.LNK 
.PSECT 



; LINK TO NEXT LCB 

; LOGICAL NAME OF DEVICE 

; LOGICAL UNIT NUMBER 

; TYPE OF ENTRY (0=SYSTEM WIDE) 

;TI UCB ADDRESS 

ASSIGNMENT UCB ADDRESS 

; LENGTH OF LCB 



.MACRO 
. ENDM 
. ENDM 



LCBDF$ / X / Y 



B-27 



RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



MTADFS 



.MACRO MTADF$,L,B 
.ASECT 

ANSI MAGTAPE SPECIFIC DATA STRUCTURES 

VOLUME SET CONTROL BLOCK OFFSET DEFININTIONS (VSCB) 
VOLUME SET AND PROCESS CONTROL SECTION 



.=0 










V.TCNT: 'L ' 


.BLKW 


1 


; TRANSACT ION COUNT 


V.TYPE 


: 'L' 


. BLKB 


1 


;VOLUME TYPE DESCRIPTOR 


V. VCHA: "L ' 


.BLKB 


1 


;VOLUME CHARACTERISTICS 


V.LABL: 'L ' 


. BLKB 


12 . 


•FILE SET ID (FIRST STX BYTES} 


V.NXT: 


■L' 


.BLKW 


1 


;PTR TO NEXT VSCB NODE 


V.MVL: 


'L' 


. BLKW 


1 


• PTR TO MflllNTFn XTCtT X T<?T 


V.UVL: 


L' 


.BLKW 


1 


;PTR TO UNMOUNTED VOL LIST 


V.ATL: 


'L' 


.BLKW 


1 


;ATL ADDR OF ACCESSING TASK 










; TCB IN RSX11M 


V.UCB: 


■L' 


.BLKW 


1 


; ADDR OF CURRENT UCB OR PUD 


V.RVOL: 'L 1 


.BLKB 


1 


;CURRENT RELATIVE VOL # 


V.MOU: 


•L' 


.BLKB 


1 


;MOUNT MODE BYTE 


V.TCHR 


• 'L ' 


.BLKW 


1 


;UINT CHAR. FOR ALL UNITS USED FOR VOL 


V.SEQN 


: 'L' 


.BLKW 


1 


;CURRENT FILE SEQUENCE # 


V.SECN 


'L' 


.BLKW 


1 


;CURRENT FILE SECTION # 


V.TPOS 


: 'L' 


.BLKB 


1 


; POSITION OF TAPE IN TM'S TO NXT HDR1 


V.PSTA 


: 'L • 


.BLKB 


1 


; PROCESS STATUS BYTE 


V.TIMO 


'L' 


.BLKW 


1 


;BLOCKED PROCESS TIMEOUT COUNTER 


V.STAT 


'L ' 


.BLKW 


3 


; STATUS WORDS USED BY COMMAND 










;EXECUTION MODULES 


V.TRTB: 'L' 


.BLKB 


1 


; TRANSLATION CONTROL BYTE 


V. EFTV: 'L • 


.BLKB 


1 


;FOR MAG TO RETURN IE. EOF, EOT, EOV 


; LABEL DATA SECTION 




V.BLKL 


'B' 


.BLKW 


1 


;BLOCK LENGTH 


V.RECL 


'B' 


• BLKW 


1 


; RECORD LENGTH 


V.FNAM 


'L' 


.BLKW 


3 


;FILE NAME 


V.FTYP 


'L' 


.BLKW 


1 


;FILE TYPE 


V.FVER 


'L' 


.BLKW 


1 


;FILE VERSION # 


V.CDAT 


'L' 


.BLKW 


2 


;CREATION DATE 


V.EDAT 


'L' 


.BLKW 


2 


;EXPRIATION DATE 


V.BLKC 


'L' 


.BLKW 


2 


;BLOCK COUNT FOR FILE SECTION 


V.RTYP 


•L' 


.BLKB 


1 


; RECORD TYPE 


V.FATT 


'L' 


.BLKB 


1 


;FILE ATTRIBUTES FOR CARRIAGE CONTROL 






.BLKB 


30. 


REMAINDER OF FILE ATTRIBUTES 



NULL WINDOW SECTION 



V.WINDi'L 1 .BLKW 4. ; NULL WINDOW 

• ***** 
i 
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V.MST2: 


•L' 


.BLKW 


1 


; MAGTAPE STATUS BITS 


V. FABY: 


1 L 1 


.BLKB 


1 


;FILE ACCESSIBILITY BYTE (HDRl) 






.BLKB 


1 


; SPARE 


V.ANSN: 


1 L 1 


.BLKB 


17. 


;ANSI 17 CHARACTER FILE NAME 


V.BOFF: 


1 L ' 


.BLKB 


1. 


;BUFFER OFFSET 


V.DENS: 


1 L ' 


.BLKB 


1. 


;REQUESTED UNIT DENSITY 


V. DRAT : 


' L 1 


.BLKB 


1. 


; DEFAULT RECORD ATTRIBUTES 


V.DBLK: 


' L 1 


.BLKW 


1. 


;DEFAULT BLOCK SIZE 


V.DREC: 


■L 1 


. BLKW 


1. 


; DEFAULT RECORD SIZE 




.***** 
i 






S.VSCB= 








;SIZE OF VSCB 



.PSECT 



; DEFINE OFFSETS INTO NULL WINDOW SECTION 
.ASECT 

.=0 

W.CTL: .BLKW 1 ;CONTROL WORD IN WINDOW 



V.WINC=V.WIND+W.CTL 


; CNTRL WORD IN NULL WINDOW 




.PSECT 


; RELATIVE TO THE VSCB 


; MOUNTED 


VOLUME LIST OFFSET 


DEFININTIONS (MVL) 




.ASECT 




.=0 








.IF DF R$$11M 




M . NXT : ' L ' 


.BLKW 1 


;PTR TO NXT MVL NODE (11M) 




. ENDC 




M.UIC: 'L 1 


.BLKW 1 


; OWNER UIC FROM RVOL #1 


M.CH: 'L' 


.BLKW 1 


; U.CH/U.VP (HD) 


M.PROT: 'L 


.BLKW 1 


^•PROTECTION U.AR IN 11D 




.IF NDF R$$11M 






.BLKW 2 


; ACP WORDS 11D 


M . NXT : 1 L 1 


.BLKW 1 


;PTR TO NEXT MVL NODE (11D) 




.ENDC 




M . RVOL : ' L 


.BLKB 1 


; RELATIVE VOL # OF MOUNTED VOLUME 


M.STAT: "L 


.BLKB 1 


; VOLUME STATUS 


M.VIDP: "L 


.BLKW 1 


;VOLUME ID POINTER 


M . UCB : • L ' 


.BLKW 1 


; ADDR OF ASSOC UCB OR PUD 


S.MVL=. 




;SIZE OF MVL NODE 




.PSECT 





UNMOUNTED VOLUME AND VOLUME LIST OFFSET DEFINITIONS (UVL) 







.ASECT 






.=0 










L.NXT: ' 


L' 


.BLKW 1 


;PTR TO NXT UVL NODE 




L.VOL1: 


"L 1 


.BLKB 1 


; REL VOL # OF l'ST VOL 


IN NODE 


L. VOL2: 


"L' 


.BLKB 1 


; REL VOL # OF 2'ND VOL 


IN NODE 


L.VID1: 


»L' 


.BLKB 6 


;VOL ID OF 1 'ST VOL IN 


NODE 


L.VID2: 


"L' 


.BLKB 6 


;VOL ID OF 2'ND VOL IN 


NODE 


S.UVL=. 




.PSECT 


;SIZE OF UVL NODE 





; SYSTEM DATA STRUCTURE CONTENT VALUES 



; VSCB VALUES 
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; V.MOU VALUES 
VM . OLD= 'B 1 200 



VM . BYP= 1 B 
VM.ULB='B 
VM.FSC= 'B 
VM.EXC='B 



100 
40 
20 
10 



V.MST2 VALUES [ [B 



;OLD .FL300 VOLUME — VM.BYP WILL ALSO 
; BE SET 

;BYPASS LABEL PROCESSING 

; UNLABELED TAPE 

; OVERRIDE FILE SET ID CHECK 

;OVERRIDE EXPIRATION DATE CHECK 



V2. INI='B' 
V2.XH2= 'B * 
V2.XH3='B 1 
V2.NH3='B' 
V2.0AC='B' 



1 
2 
4 
10 
20 



;MAG WANTS US TO INITIALIZE NEXT OUTPUT 
;THIS FILE HAS NO HDR2 , DON'T WRITE EOF2 
;THIS FILE HAS NO HDR3 , DON'T WRITE EOF3 
;DON'T WRITE HDR3/EOX3 LABELS 
;OVERRIDE FILE/VOLUME ACCESSIBILITY 



; V.PSTA VALUES - UNBLOCKED TRANSITION STATE 



VP . RM= 'B ' 
VP.WM= 'B ' 
VP.UCM='B ' 
VP.SM= 'B 1 
VP.MOU='B ' 
VP.RWD= 'B ' 
VP. VFY='B ' 
VP. POS='B ' 



2 
4 
6 
10 
20 
40 
VP . RWD 
100 



; READ DATA MODE 
;WRITE DATA MODE 

; UNLABELLED CREATE POSITIONING MODE 
; SEARCH MODE 
;MOUNT MODE 

; REWIND OR VOL VERIFICATION WAIT 

;PROCESS IN POSITIONING MODE (MULTI -SECTION 
;FILE) 



BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES; 

PROCESS TIMED OUT BIT 0=1 
VP.TO=l 



NULL WINDOW CONTROL BIT DEFINITIONS 



WI.RDV='B' 
WI ,WRV= 'B ' 
WI.EXT='B ' 
WI.LCK='B' 



400 
1000 
2000 
4000 



;ACCESSED FOR READ 

;ACCESSED FOR WRITE 

;ACCESSED FOR EXTEND 
; LOCKED 



MVL VALUES IN THE M.STAT FIELD 



MS.VER= 


'B' 


200 


;VOL ID NOT VERIFIED 


MS.RID= 


'B' 


1 


;VOL ID TO BE READ NOT CHECKED 


MS.NMO= 


'B' 


2 


;MOUNT MESSAGE NOT GIVEN YET 


MS.TMO= 


'B' 


4 


;ONE TIMEOUT ALREADY EXPRIED 


MS.EXP= 


'B' 


10 


;EXPIRATION DATE MESSAGE GIVEN 


; MISC 


BITS 


USED IN MOUNT 


(STORED IN V.STS) 


MO.OVR= 


'B' 


1 


; OVER RIDE VOL NAME SWITCH 


MO.UIC= 


'B' 


2 


; EXPLICIT UIC GIVEN 


MO. PRO= 


'B' 


4 


; EXPLICIT PROTECTION GIVEN 


MO. 160= 


'B' 


10 


; 1600 BPI SPECIFIED 



. ENDM 
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.MACRO PCBDF$ L,B 



PARTITION CONTROL BLOCK OFFSET DEFINITIONS 





.ASECT 






.=0 








P . LNK : 1 L ' 


• BLKW 


1 


; LINK TO NEXT PARTITION PCB 


P.PRI: 'L' 


. BLKB 


1 


; PRIORITY OF PARTITION 


P. IOC: 'L' 


.BLKB 


1 


;I/0 + I/O STATUS BLOCK COUNT 


P . NAM : • L ' 


.BLKW 


2 


; PARTITION NAME IN RAD 50 


P. SUB : 'L« 


.BLKW 


1 


;POINTER TO NEXT SUBPARTITION 


P. MAIN: 'L' 


.BLKW 


1 


; POINTER TO MAIN PARTITION 




.IF NB 


SYSDEF 





.IF NDF M$$MGE 



P. HDR: 1 L 



; POINTER TO HEADER CONTROL BLOCK 



. ENDC 



. IFTF 

P.REL: ' L' .BLKW 1 

P.BLKS: 'L 1 

P. SIZE: 'L 1 .BLKW 1 



P. WAIT: 'L' .BLKW 1 

P.SWSZ: 'L 1 .BLKW 1 

P. BUSY: 'L 1 .BLKB 2 
P . OWN : ' L 1 

P.TCB: 'L' .BLKW 1 

P.STAT: 'L' .BLKW 1 

. IFT 



;STARTING PHYSICAL ADDRESS OF PARTITION 

SIZE OF PARTITION IN: 

UNMAPPED SYSTEMS - BYTES 

MAPPED SYSTEMS - 32 WORD BLOCKS 

PARTITION WAIT QUEUE LISTHEAD (2 WORDS) 

PARTITION SWAP SIZE (SYSTEM ONLY) 

PARTITION BUSY FLAGS 

;TCB ADDRESS OF OWNER TASK 
; PARTITION STATUS FLAGS 



.IF DF 
P. HDR: 'L 1 .BLKW 1 
.ENDC 



M$$MGE 



; POINTER TO HEADER CONTROL BLOCK 



P. PRO: 'L' .BLKW 1 
P. ATT: 'L' .BLKW 2 



PROTECTION WORD [DEWR , DEWR , DEWR , DEWR ] 
; ATTACHMENT DESCRIPTOR LISTHEAD 



.IF NDF P$$LAS 



P . LGTH= 'B 'P. PRO 



; LENGTH OF PARTITION CONTROL BLOCK 



IFF 
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P.LGTH= 'B 1 . 



; LENGTH OF PARTITION CONTROL BLOCK 



. ENDC 
. IFF 

.PSECT 



PARTITION STATUS WORD BIT DEFINITIONS 



PS 


. OUT = 


'B' 


100000 ; 


PARTITION IS OUT OF MEMORY ( 1=YES ) 


PS 


,CKP= 


'B 1 


40000 


PARTITION CHECKPOINT IN PROGRESS (1=YES) 


PS 


.CKR = 


'B' 


20000 , 


PARTITION CHECKPOINT IS REQUESTED (1=YES) 


PS 


.CHK = 


•B' 


10000 


PARTITION IS NOT CHECKPOINTABLE (1=YES) 


PS 


.FXD = 


'B' 


4000 ; 


PARTITION IS FIXED (1=YES) 


PS 


. PER = 


'B 1 


2000 ; 


PARITY ERROR IN PARTITION (1=YES) 


PS 


.LIO = 


'B' 


1000 ; 


MARKED BY SHUFFLER FOR LONG I/O (1=YES) 


PS 


.NSF = 


•B 1 


400 ; 


PARTITION IS NOT SHUFFLEABLE (1=YES) 


PS 


.COM= 


'B' 


200 ; 


LIBRARY OR COMMON BLOCK (1=YES) 


PS 


. PIC = 


'B' 


100 


POSITION INDEPENDENT LIBRARY OR COMMON 










(1=YES) 


PS 


.SYS = 


'B' 


40 


•SYSTEM CONTROLLED PARTITION (1=YES) 


PS 


.DRV= 


■B ' 


20 ; 


DRIVER IS LOADED IN PARTITION (1=YES) 


PS 


. DEL = 


'B' 


10 


PARTITION SHOULD BE DELETED WHEN NOT 










ATTACHED (1=YES) 


PS.APR= 


'B' 


7 


^STARTING APR NUMBER MASK 



ATTACHMENT DESCRIPTOR OFFSETS 



.ASECT 



.=0 








A. PCBL: 


'L' 


.BLKW 


1 


A. PRI : ' 


L' 


. BLKB 


1 


A. IOC: • 


L' 


.BLKB 


1 


A.TCB: ' 


L' 


.BLKW 


1 


A.TCBL: 


' L 1 


.BLKW 


1 


A.STAT: 


'L' 


.BLKB 


1 


A.MPCT: 


•L' 


.BLKB 


1 


A . PCB : 1 


L' 


.BLKW 


1 


A. LGTH= 


'B' 







PCB ATTACHMENT QUEUE THREAD WORD 
PRIORITY OF ATTACHED TASK 
I/O COUNT THROUGH THIS DESCRIPTOR 
TCB ADDRESS OF ATTACHED TASK 
TCB ATTACHMENT QUEUE THREAD WORD 
STATUS BYTE 

MAPPING COUNT OF TASK THRU THIS DESCRIPTOR 
PCB ADDRESS OF ATTACHED TASK 
LENGTH OF ATTACHMENT DESCRIPTOR 



ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS 



.PSECT 



AS . DEL= 'B 1 
AS.EXT= 'B ' 
AS.WRT='B' 
AS . RED= 'B ' 



10 
4 
2 
1 



; TASK HAS DELETE ACCESS (1=YES) 

; TASK HAS EXTEND ACCESS (1=YES) 

; TASK HAS WRITE ACCESS (1=YES) 

; TASK HAS READ ACCESS (1=YES) 



.ENDC 



.MACRO PCBDF$ X,Y,Z 

. ENDM 
. ENDM 
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.MACRO PKTDF$,L,B 



ASYNCHRONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS 

SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL 
BLOCK ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 



.ASECT 
.=177774 
A.KSR5: 'L' 
A.DQSR: 'L' 



A.CBL: ' L ' 



.BLKW 
.BLKW 
.BLKW 
.BLKW 



A. BYT: 'L' 
A. AST: 'L' 
A.NPR: 'L' 
A.PRM: 'L' 



.BLKW 1 
.BLKW 1 
.BLKW 1 
.BLKW 1 



SUBROUTINE KISAR5 BIAS (A.CBL=0) 

DEQUEUE SUBROUTINE ADDRESS (A.CBL=0) 

AST QUEUE THREAD WORD 

LENGTH OF CONTROL BLOCK IN BYTES 

IF A.CBL = 0, THE AST CONTROL BLOCK IS 

TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE 

POINTED TO BY A.DQSR MAPPED VIA APR 5 

VALUE A.KSR5. THIS IS CURRENTLY USED ONLY 

BY THE FULL DUPLEX TERMINAL DRIVER FOR 

UNSOLICITED CHARACTER ASTS . 

IF THE LOW BYTE OF A.CBL = 0, AND THE 

HIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK 

IS A SPECIFIABLE AST, WITH LENGTH, C.LGTH. 

IF THE HIGH BYTE OF A.CBL = AND THE LOW 

BYTE > 0, THEN THE LOW BYTE IS THE LENGTH 

OF THE AST CONTROL BLOCK. IF THE HIGH BYTE 

OF A.CBL = AND THE LOW BYTE IS NEGATIVE, 

THIS IS A KERNEL AST. SEE BELOW FOR 

A DESCRIPTION OF A.CBL FOR KERNEL ASTS. 

NUMBER OF BYTES TO ALLOCATE ON TASK STACK 

AST TRAP ADDRESS 

NUMBER OF AST PARAMETERS 

FIRST AST PARAMETER 



THE SPECIFIABLE AST CODES MUST NOT BE 0. 



AS.FPA='B' 
AS.RCA='B I 
AS ,RRA= 'B * 
AS.PFA='B' 
AS ,REA= ' B 1 
AS.CAA= 'B ' 



;CODE FOR FLOATING POINT AST 

;CODE FOR RECEIVE DATA AST 

;CODE FOR RECEIVE BY REFERENCE AST 

;CODE FOR POWERFAIL AST 

;CODE FOR REQUESTED EXIT (ABORT) AST 

;CODE FOR COMMAND ARRIVAL AST FOR CLIS 



BIT VALUES IN A.PRM+5 



AF . XCC= 


'B' 


1 


; ATTACHED FOR ALL BUT CONTROL-C 


(TF.XCC) 


AF . NOT= 


'B' 


2 


; ATTACHED FOR ALL NOTIFICATION 


(TF.NOT) 


AF.OOB= 


'B 1 


4 


;ACB IS FOR OUT-OF-BAND AST 




AF . AST= 


•B' 


10 


;ACB HANDLES UNSOL. INPUT CHAR 


AST'S (TF. AST) 


AF . ESQ= 


•B' 


20 


; ATTACHED FOR ESCAPE SEQUENCES 


(TF.ESQ) 


AF.LCK= 


'B 1 


40 


;ACB IS LOCKED 




AF . QUE= 


'B' 


100 


;ACB IS QUEUED 




AF.MDE= 


'B' 


200 


;ACB IS MARKED FOR DELETE 
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ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S 
STACK 



AB.NPV='B' 
AB.TYP= 'B 1 



; ABORTER IS NONPRIVILEGED (1=YES) 
; ABORT FROM DIRECTIVE (0=YES) 
; ABORT FROM CLI COMMAND (1=YES) 



KERNEL AST CONTROL BLOCK DEFINITIONS 

THE LOW BYTE OF A.CBL FOR A KERNEL AST HAS THE FOLLOWING FORMAT: 
BIT #200 ALWAYS EQUALS 1 

BIT #100 IS ZERO IF $SGFIN MUST BE CALLED DURING AST 
PROCESSING THE REMAINING SIX BITS ARE USED AS THE 
KERNEL AST TYPE FIELD 

BECAUSE THERE ARE ONLY 6 BITS AVAILABLE TO THE KERNEL AST 
INDEX FIELD, ONLY (2**6 )-l KERNEL AST TYPES ARE POSSIBLE. 



AK. BUF= 1 B ' 200 

AK.OCB= , B l 201 

AK. GBI = *B ' 202 

AK. GGF= 'B ' 303 



;BUFFERED I/O COMPLETION AST 
;OFFSPRING EXIT 
;GENERAL BUFFERED I/O AST 
; GROUP GLOBAL RUNDOWN AST 



OFFSPRING CONTROL BLOCK DEFINITIONS 

SOME POSITIONAL DEPENDENCIES EXIST BETWEEN THE OCB AND THE AST 
CONTROL BLOCK IN ROUTINE $FINXT IN MODULE SYSXT 



.=0 

O. LNK: ' L ' . BLKW 1 ;OCB LINK WORD 

O.MCRL:'L' .BLKW 1 ; ADDRESS OF MCR COMMAND LINE 

O.PTCBr'L' .BLKW 1 ; PARENT TCB ADDRESS 

O.ASTr'L' .BLKW 1 ;EXIT AST ADDRESS 

O.EFN:'L' .BLKW 1 ;EXIT EVENT FLAG 

O.ESBl'L .BLKW 1 ;EXIT STATUS BLOCK VIRTUAL ADDRESS 

O.STAT: 'L' .BLKW 8. ;EXIT STATUS BUFFER 

O . LGTH= 'B ' . ; LENGTH OF OCB 



I/O PACKET OFFSET DEFINITIONS 









.ASECT 






= 










I 


.LNK: 


'L' 


.BLKW 


1 


;I/0 QUEUE THREAD WORD 


I 


.PRI : 


'L' 


. BLKB 


1 


; REQUEST PRIORITY 


I 


. EFN : 


'L' 


• BLKB 


1 


; EVENT FLAG NUMBER 


I 


.TCB: 


•L' 


.BLKW 


1 


;TCB ADDRESS OF REQUESTOR 


I 


. LN2: 


'L' 


.BLKW 


1 


; POINTER TO SECOND LUN WORD 


I 


.UCB: 


■L' 


.BLKW 


1 


; POINTER TO UNIT CONTROL BLOCK 


I 


. FCN : 


•L' 


.BLKW 


1 


;I/0 FUNCTION CODE 
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I . IOSB: 'L 1 



I .AST : 'L 1 
I.PRM: 'L 1 



.BLKW 1 ;VIRTUAL ADDRESS OF I/O STATUS BLOCK 

.BLKW 1 ;I/0 STATUS BLOCK RELOCATON BIAS 

.BLKW 1 ;I/0 STATUS BLOCK ADDRESS 

.BLKW 1 ;AST SERVICE ROUTINE ADDRESS 

.BLKW 1 /RESERVED FOR MAPPING PARAMETER #1 

.BLKW 6 ; PARAMETERS 1 TO 6 

.BLKW 1 ;USER MODE DIAGNOSTIC PARAMETER WORD 



FOLLOWING ARE DEFINITIONS FOR FLAG BITS IN I.PRM+11 
(DSA DRIVERS INTERNAL USE ONLY) 



IP.FAK='B' 
IP.ABO='B l 
IP.PND='B' 
IP.UMR='B' 

I . ATTL= 'B 1 



I . LGTH= 1 B 1 



20 
40 
100 
200 



;IOP IS PSEUDO IOP 

; (MUDRV) ABORT COMMAND MUST BE ISSUED FOR IOP 

/ (MUDRV) ABORT COMMAND WAS ISSUED FOR IOP 

;A UMR WAIT BLOCK IS IN USE FOR THIS I/O 

/MINIMUM LENGTH OF I/O PACKET (USED BY 
; FILE SYSTEM TO CALCULATE MAXIMUM 
/NUMBER OF ATTRIBUTES) 

/LENGTH OF I/O REQUEST CONTROL BLOCK 



DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX) 
.ASECT 



.=0 



XLNK : ■ L ' 
XIOP: 'L' 
XTCB : " L 1 
XMOD : 1 L 1 



.BLKW 1 
.BLKW 1 
.BLKW 1 
.BLKW 2 



I.XRBF: 'L' .BLKW 2 



I . XRBL : 1 L 1 
I . XTMO : 1 L 1 
I.XPBF: 'L' 

I.XPBL: 'L* 
I . XPBV: 'L ' 
I.XTTB: 'L' 

I.XTTL: 'L' 
I . XDBF : ' L ' 



, BLKW 1 

.BLKW 1 

,BLKW 2 

, BLKW 1 

,BLKW 1 

, BLKW 2 

.BLKW 1 

.BLKW 2 



I.XDBL: 'L' .BLKW 1 



LINK WORD 

I/O PACKET ADDRESS 

TCB ADDRESS OF REQUESTING TASK 

MODIFIER WORDS (NOTE: 2ND WORD MUST BE 

SPECIFIED AND MUST BE ZERO.) 

READ DATA BUFFER ADDRESS APR BIAS 

READ DATA BUFFER VIRTUAL ADDRESS 

READ DATA BUFFER LENGTH 

READ TIME-OUT INTERVAL 

PROMPT BUFFER ADDRESS APR BIAS 

PROMPT BUFFER VIRTUAL ADDRESS 

PROMPT BUFFER LENGTH 

PROMPT BUFFER VERTICAL FORMS CONTROL 
TERMINATOR TABLE ADDRESS APR BIAS 
TERMINATOR TABLE VIRTUAL ADDRESS 
TERMINATOR TABLE LENGTH 

DEFAULT INPUT BUFFER ADDRESS APR BIAS 
DEFAULT INPUT BUFFER VIRTUAL ADDRESS 
DEFAULT INPUT BUFFER LENGTH 



GROUP GLOBAL EVENT FLAG CONTROL BLOCK OFFSETS 



.=0 

G.LNK: 'L' 
G.GRP: 'L' 
G.STAT: 'L ' 
G.CNT: 'L' 
G.EFLG: 'L' 
G.LGTH= 'B' 



.BLKW 1 /LINK WORD 

. BLKB 1 /GROUP NUMBER 

•BLKB 1 /STATUS BYTE 

.BLKW 1 /ACCESS COUNT 

.BLKW 2 /EVENT FLAGS 

/LENGTH OF GROUP GLOBAL CONTROL BLOCK 
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; STATUS BYTE DEFINITIONS 



GS.DEL='B'l 



;GROUP MARKED FOR DELETE 



; + 

; EXECUTIVE POOL MONITOR CONTROL FLAGS 

r ~~ 

; $POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR 



PC.HIH='B I 
PC.LOW='B' 
PC.ALF='B' 
PC.XAF= , B' 
PC.XIT='B' 
PC.NRM='B ' 
PC.ALM= I B' 



1 
2 
4 
10 
200 

PC.HIH*400 
PC.LOW*400 



HIGH POOL LIMIT CROSSED (1=YES) 

LOW POOL LIMIT CROSSED (1=YES) 

FAILED TO ALLOCATE LARGE BLOCK (1=YES) 

FAILED TO ALLOCATE SMALL BLOCK (1=YES) 

FORCE POOL MONITOR TASK TO EXIT 

POOL TASK INHIBIT BIT FOR HIGH POOL 

POOL TASK INHIBIT BIT FOR LOW POOL 



$POLFL IS THE POOL USAGE CONTROL WORD 



PF.INS='B' 
PF.LOG= 'B 1 
PF . REQ= 'B ' 



40 
100 
200 



; REJECT NONPRIVILEGED INS/RUN/REM 

; LOGINS ARE DISABLED 

;STALL REQUEST OF NONPRIV. TASKS 



PF . ALL= 'B ' 177777 



; TAKE ALL POSSIBLE ACTIONS TO SAVE POOL 



CLI PARSER BLOCK (CPB) DEFINITIONS 



.=0 

C.PTCB: 'L' 
C . PNAM : ' L * 
C.PSTS: 'L' 
C.PDPL: 'L 1 
C.PCPL: 'L 1 
C . PRMT : ' L 1 



.BLKW 1 ; ADDRESS OF CLI 'S TCB 

. BLKW 2 ;CLI NAME 

.BLKW 1 ; STATUS MASK 

. BLKB 1 ; LENGTH OF DEFAULT PROMPT 

.BLKB 1 ; LENGTH OF CNTRL/C PROMPT 

; START OF ASCII PROMPT STRINGS 

; THE DEFAULT STRING IS CONCANTENATED 

;WITH THE "C STRING 



STATUS BIT DEFINITIONS 



CP.NUL= 


B' 


1 


;PASS EMPTY COMMAND LINES TO CLI 


CP.MSG= 


'B' 


2 


;CLI DESIRES SYSTEM MESSAGES 


CP.LGO= 


'B' 


4 


;CLI WANTS COMMANDS FROM LOGGED OFF TTYS 


CP.DSB= 


•B' 


10 


;CLI IS DISABLED 


CP. PRV= 


'B' 


20 


;USER MUST BE PRIV TO SET TTY TO THIS CLI 


CP.SGL= 


•B' 


40 


;DON'T HANDLE CONTINUATIONS (M-PLUS ONLY) 


CP.NIO= 


•B' 


100 


;MCR..., HEL, BYE DO NO I/O TO TTY 








;HEL, BYE ALSO DO NOT SET CLI ETC. 


CP.RST= 


'B' 


200 


; ABILITY TO SET TO THIS CLI IS RESTRICTED 








;TO THE CLI ITSELF 


CP. EXT= 


'B ' 


400 


;PASS TASK EXIT PROMPT REQUESTS TO CLI 


; IDENTIFIER CODES 


FOR SYSTEM TO CLI MESSAGES. 


; CODES 


- 


127. ARE RESERVED FOR USE BY DIGITAL, 


; CODES 


128 


. - 255 


. ARE RESERVED FOR USE BY CUSTOMERS 
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CM. 


INE = 


'B' 


1 


;CLI INITIALIZED ENABLED 


CM. 


IND = 


•B 1 


2 


;CLI INITIALIZED DISABLED 


CM. 


CEN = 


'B' 


3 


;CLI ENABLED 


CM. 


CDS = 


'B' 


4 


;CLI DISABLED 


CM. 


ELM = 


'B' 


5 


;CLI BEING ELIMINATED 


CM. 


EXT = 


'B' 


6 


;CLI MUST EXIT IMMEDIATELY 


CM. 


LKT = 


'B' 


7 


;NEW TERMINAL LINKED TO CLI 


CM. 


RMT = 


•B' 


8. 


; TERMINAL REMOVED FROM CLI 


CM. 


MSG = 


•B' 


9. 


; GENERAL MESSAGE TO CLI 



ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS 














A. 


REL: ' 


L' 


.BLKW 


1 


A. 


DIS: ' 


L' 


. BLKW 


1 


A. 


MAS: 1 


L' 


.BLKW 


2 


A. 


NUM: 1 


L' 


. BLKB 


1 


A. 


FLEN: 


'L' 


.BLKB 


1 


A. 


LIN: ' 


L' 


. BLKW 


1 


A. 


ACC: ' 


L' 


.BLKB 


1 


A. 


STA: 1 


L' 


.BLKB 


1 


A. 


PLEN = 


'B' 








A.LIN 






A. 


IMAP: 


'L' 


.BLKW 


1 


A. 


IBUF: 


'L' 


.BLKW 


1 


A. 


ILEN: 


'L' 


.BLKW 


1 


A. 


SMAP: 


•L' 


.BLKW 


1 


A. 


SBUF: 


'L' 


.BLKW 


1 


A. 


SLEN: 


'L' 


.BLKW 


1 


A. 


IOS: ' 


L' 


.BLKW 


2 


A. 


RES=' 


B 1 







;ACD RELOCATION BIAS 

;ACD DISPATCH TABLE POINTER 

;ACT FUNCTION MASK 

;ACD IDENTIFICATION NUMBER 

; LENGTH IN BYTES OF FULL ACB 

;ACD LINK WORD 

;ACD ACCESS COUNT 

;ACD STATUS BYTE 

; LENGTH IN BYTES OF PROTOTYPE ACB 

; FULL ACB OVERLAPS PROTOTYPE ACB 

;ACD INTERRUPT BUFFER RELOCATION BIAS 

;ACD INTERRUPT BUFFER ADDRESS 

;ACD INTERRUPT BUFFER LENGTH 

;ACD SYSTEM STATE BUFFER RELOCATION BIAS 

;ACD SYSTEM STATE BUFFER ADDRESS 

;ACD SYSTEM STATE BUFFER LENGTH 

;ACD I/O STATUS 

; START OF ACB RESERVED FOR USE BY THE ACD 



DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG 



UA. 


ACC = 


'B' 


1 


;ACCEPT THIS CHARACTER 


UA. 


PRO== 


•B' 


2 


; PROCESS THIS CHARACTER 


UA. 


ECH = 


'B' 


4 


;ECHO THIS CHARACTER 


UA. 


TYP = 


•B' 


10 


;FORCE THIS CHARACTER INTO TYPEAHEAD 


UA. 


SPE = 


'B 1 


20 


;THIS CHARACTER HAS A SPECIAL ECHO 


UA. 


PUT== 


'B' 


40 


;PUT THIS CHARACTER IN THE INPUT BUFFER 


UA. 


CAL== 


'B' 


100 


;CALL THE ACD BACK AFTER THE TRANSFER 


UA. 


COM== 


'B' 


200 


;COMPLETE THE INPUT REQUEST 


UA. 


ALL = 


'B' 


400 


;ALLOW PROCESSING OF THIS I/O REQUEST 


UA. 


TRN== 


•B' 


1000 


; TRANSLATE CHARACTERS FROM OUTPUT QIO 


UA. 


TRA== 


'B 1 


2000 


; TRANSFER CHARACTERS WHEN I/O COMPLETES 



DEFINE THE ACD ENTRY POINTS (OFFSETS INTO THE DISPATCH TABLE) 



.=0 

A.ACCE: 'L' 
A.DEQU: 'L' 
A . POWE : ' L ' 
A. INPU: 'L' 



.BLKW 1 ;I/0 REQUEST ACCEPTANCE ENTRY POINT 

.BLKW 1 ;I/0 REQUEST DEQUEUE ENTRY POINT 

.BLKW 1 ; POWER FAILURE ENTRY POINT 

.BLKW 1 ; INPUT COMPLETION ENTRY POINT 
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A.OUTPr'L' . BLKW 1 ;OUTPUT COMPLETION ENTRY POINT 

A . CONN : ' L ' .BLKW 1 ;CONNECTION ENTRY POINT 

A.DISC:'L' . BLKW 1 ^'DISCONNECTION ENTRY POINT 

A.RECEr'L' .BLKW 1 ; INPUT CHARACTER RECEPTION ENTRY POINT 

A.PROC:'L' .BLKW 1 ;INPUT CHARACTER PROCESSING ENTRY POINT 

A . TRAN : 1 L 1 .BLKW 1 ;OUTPUT QIO CHARACTER TRANSLATION ENTRY POINT 

A. CALL: 'L 1 .BLKW 1 ;CALL ACD BACK AFTER TRANSFER ENTRY POINT 

DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB 



AS . DLT= 'B ' 1 
AS.DIS='B I 2 

.PSECT 



;ACD IS MARKED FOR DELETE 
;ACD IS DISABLED 



.MACRO PKTDF$ X,Y,Z 
. ENDM 
. ENDM 
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THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE 
CONTROLLER. THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM. 
THE SCB IS POINTED TO BY UNIT CONTROL BLOCKS. TO EXPAND ON THE 
TELETYPE EXAMPLE ABOVE, EACH TELETYPEWRITER TYPE INTERFACED VIA 
A DL11-A WOULD HAVE A SCB SINCE EACH DLll-A IS AN INDEPENDENT 
INTERFACE UNIT. THE TELETYPES INTERFACED VIA THE DHll WOULD 
ALSO EACH HAVE AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT 
MULTIPLEXES MANY UNITS IN PARALLEL. 



.ASECT 



.=177772 








S.RCNT: 


•L' 


.BLKB 


1 ; 


NUMBER OF REGISTERS TO COPY ON ERROR 


S . ROFF : 


1 L ' 


. BLKB 


1 


OFFSET TO FIRST DEVICE REGISTER 


S.BMSV: 


1 L 1 


.BLKW 


1 j 


SAVED I/O ACTIVE BITMAP AND POINTER TO 


S.BMSK: 


'L 1 


.BLKW 


1 , 


DEVICE I/O ACTIVE BIT MASK 


S.LHD: 1 


L' 


.BLKW 


2 


CONTROLLER I/O QUEUE LISTHEAD 


S.PRI : 1 


L' 


.BLKB 


1 j 


DEVICE PRIORITY 


S.VCT: ■ 


L 1 


.BLKB 


1 j 


INTERRUPT VECTOR ADDRESS /4 


S.CTM: • 


L' 


.BLKB 


1 


•CURRENT TIMEOUT COUNT 


S . ITM : 1 


L' 


.BLKB 


1 


INITIAL TIMEOUT COUNT 


S.CON: ' 


L' 


.BLKB 


1 


fCONTROLLER INDEX 


S.STS: ' 


L' 


.BLKB 


1 


CONTROLLER STATUS (0=IDLE , 1=BUSY) 


S.CSR: ' 


L 1 


.BLKW 


1 


; ADDRESS OF CONTROL STATUS REGISTER 


S . PKT : ' 


L' 


.BLKW 


1 


ADDRESS OF CURRENT I/O PACKET 


S.FRK: ' 


L' 


.BLKW 


1 


;FORK BLOCK LINK WORD 


S . DMCS : 


'L' 






DMll-BB CSR FOR FDX TTDRV 






.BLKW 


1 


; FORK-PC 






.BLKW 


1 ; 


FORK-R5 






.BLKW 


1 


?FORK-R4 



.IF NB SYSDEF 

.IF DF L$$DRV & M$$MGE 

.BLKW 1 ; FORK-DRIVER RELOCATION BASE 

. ENDC 



S . PORT : 1 L ' 

S.PBIA='B' S.PORT+2 

S.QST='B' S.PORT+4 

S.BSYU='B' S.PORT+6 



S.CCB: 'L 1 
S.MPR: 'L ' 

S.UMHD: 'L ' 
S . UMCT : • L ' 



.BLKW 
.BLKW 
.BLKW 
.BLKW 



FIRST THREE CHAR. OF PORT NAME (RAD50) 
BIAS OF PORT COMMON 

ADDRESS OF QST , CONTROLLER STATE TABLE 
ADDRESS OF UNIT CORRESPONDING TO OLDEST CMD 

ZERO IF THERE ARE NO OUTSTANDING CMDS . 
MIXED MASSBUS CHANNEL CONTROL BLOCK 
11/70 EXTENDED MEMORY UNIBUS DEVICE C-BLOCK 
BUFFER WORD 

LIST HEAD FOR UMR ASSIGNMENT BLOCK (S) 
COUNT OF AVAILABLE UMR ASSIGNMENT BLOCK (S) 



. IFF 
.PSECT 
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STATUS CONTROL BLOCK PRIORITY BYTE CONDITION CODE STATUS BIT 
DEFINITIONS 



SP.EIP='B' 1 

SP.ENB='B' 2 

SP.LOG='B' 4 

SPARE=10 



; ERROR IN PROGRESS (1=YES) 
; ERROR LOGGING ENABLED (0=YES) 
;ERROR LOGGING AVAILABLE (1=YES) 
;SPARE BIT 



MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT] 



.=0 

M.LNK: 'L' 
M . UMRA : • L 1 
M.UMRN: 'L 1 
M . UMVL : 1 L 1 
M.UMVH: 'L' 
M.BFVH: 'L' 
M.BFVL: 'L' 
M . LGTH= 1 B ' 



.ASECT 

, BLKW 
, BLKW 
.BLKW 
. BLKW 
.BLKB 
, BLKB 
.BLKW 



, ENDC 



PSECT 



; LINK WORD 

; ADDRESS OF FIRST ASSIGNED UMR 

; NUMBER OF UMR'S ASSIGNED * 4 

;LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR 

;HIGH 2 BITS MAPPED IN BITS 4 AND 5 

; HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS 

;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 

; LENGTH OF MAPPING ASSIGNMENT BLOCK 



.MACRO SCBDF$,X,Y,Z 
. ENDM 
, ENDM 
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. MACRO TCBDF$,L,B 



TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS 
TASK CONTROL BLOCK 



SEVERAL PIECES OF PRIVILEGED CODE EXIST THAT CREATE TCBS FROM 
OTHER TCBS. SINCE THESE PIECES OF CODE ARE GENERALLY OPTIMIZED 
FOR SPEED AND DO NOT USE THE SYMBOLIC OFFSETS PROVIDED BELOW, 
ANY CHANGE IN THE TCB MUST ALSO BE MADE TO EACH OF THESE PIECES 
OF CODE. THE KNOWN LIST OF SUCH PIECES OF CODE IS AS FOLLOWS: 

LIBRARY MODULE COMMENT 



RSX11M 
MCR 



DRSPW 

MCROV,MCRDIS 



.ASECT 



.=0 

T.LNK: 
T.PRI: 
T. IOC: 
T.CPCB 
T . NAM : 
T . RCVL 
T.ASTL 
T.EFLG 
T . UCB : 
T . TCBL 
T.STAT 
T.ST 2: 
T.ST3: 
T.DPRI 
T . LBN : 
T.LDV: 
T . PCB : 
T.MXSZ 
T.ACTL 
T.SAST 

T.TIO: 
T.TKSZ 



'L' 
' L ' 
•L' 
: 'L' 
'L' 
: 'L' 
: 'L' 
: 'L' 
'L' 
: 'L' 
:'L' 
'L' 
'L' 
: "L 1 
'L' 
•L' 
1 L 1 
: ' L 1 
: »L' 
: 'L' 



1 L 



1 L ' 



$$$ = . 

T . ATT : ' L 1 
T . OFF : 1 L 1 



. BLKW 
. BLKB 
.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
• BLKW 
.BLKB 
.BLKB 
.BLKW 



,BLKW 2 
.BLKW 1 



BLKB 1 



TCB CREATED FOR RPOI$ DIRECTIVE 
MULTIUSER TASK DISPATCHING 



UTILITY LINK WORD 

TASK PRIORITY 

I/O PENDING COUNT 

POINTER TO CHECKPOINT PCB 

TASK NAME IN RAD 50 

RECEIVE QUEUE LISTHEAD 

AST QUEUE LISTHEAD 

TASK LOCAL EVENT FLAGS 1-32 

UCB ADDRESS FOR PSEUDO DEVICE 'TI' 

TASK LIST THREAD WORD 

FIRST STATUS WORD (BLOCKING BITS) 

SECOND STATUS WORD (STATE BITS) 

THIRD STATUS WORD (ATTRIBUTE BITS) 

TASK'S DEFAULT PRIORITY 

LBN OF TASK LOAD IMAGE 

UCB ADDRESS OF LOAD DEVICE 

PCB ADDRESS OF TASK PARTITION 

MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY) 

ADDRESS OF NEXT TASK IN ACTIVE LIST 

SPECIFIED AST LISTHEAD 

RESERVED BYTE (CURRENTLY MUST BE 0) 

BUFFERED I/O COUNT 

TASK SIZE (FROM L$BLDZ IN LABEL BLK) IN: 

UNMAPPED SYSTEMS - BYTES 

MAPPED SYSTEMS - 32 WORD BLOCKS 
TASK SIZE (FROM L$BMXZ IN LABEL BLK) 
FOR RSX11S SYSTEMS ONLY 

MAPPED SYSTEMS - 32 WORD BLOCKS 

UNMAPPED SYSTEMS - BYTES 

;MARK START OF PLAS AREA 

; ATTACHMENT DESCRIPTOR LISTHEAD 
; OFFSET TO TASK IMAGE IN PARTITION 
;IF A$$HDR IS DEFINED, THIS WORD ALSO 
; INCLUDES THE LENGTH OF THE ALTERNATE 
;HEADER REFRESH AREA STORED IN T.HDLN 
; RESERVED 
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T.SRCT 
T.RRFL 



.=$$$ 



'L' 
•L' 



$$$=. 

T.OCBH: 
T.RDCT: 



.=$$$ 

$$$=. 
T.EFLM: 

.=$$$ 



■L' 
■L' 



.BLKB 1 
. BLKW 2 

.IF NDF P$$LAS 



. ENDC 

.IF NB SYSDEF 



. BLKW 2 
.BLKW 1 

.IF NDF P$$OFF 



.ENDC 



.BLKW 2 



; SREF WITH EFN COUNT IN ALL RECEIVE QUEUES 
;RECEIVE BY REFERENCE LISTHEAD 



; POINT TO START OF PLAS AREA 
;P$$LAS 

;MARK START OF PARENT OFFSPRING TASKING AREA 

; OFFSPRING CONTROL BLOCK LISTHEAD 
; OUTSTANDING OFFSPRING COUNT 

;POINT TO START OF PARENT OFFSPRING AREA 
;P$$OFF 

;MARK START OF EVENT FLAG MASK AREA 

; EVENT FLAG MASK WORD 

; EVENT FLAG MASK ADDRESS 



.IF NDF S$$TOP&T$$BUF 

; POINT TO START OF EVENT FLAG MASK AREA 
.ENDC ;S$$TOP&T$$BUF 



$$$=. 

T.HDLNr'L' .BLKB 1 ; TASK HEADER LENGTH IN 32-WORD BLOCKS 

.IF NDF A$$HDR 
.=$$$ ;NOT SUPPORTED IF NDF 

.ENDC ;A$$HDR 

$$$=. 

T . GGF : ' L 1 .BLKB 1 ;GROUP GLOBAL USE COUNT FOR TASK 

.IF NDF R$$SND&G$$EFN!A$$CLI&G$$EFN 

.=$$$ 

.ENDC 
.EVEN 



T.LGTH='B ' 
T.EXT='B , 



; LENGTH OF TASK CONTROL BLOCK 
; LENGTH OF TCB EXTENSION 



. IFF 
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+ 

TASK STATUS DEFINITIONS 



FIRST STATUS WORD (BLOCKING BITS) 



TS.EXE='B' 
TS.RDN='B* 
TS.MSG='B' 
TS.NRP='B' 
TS.RUN='B' 
TS.HLD= , B I 
TS.STP='B ' 
TS.OUT='B' 
TS.CKP='B' 
TS.CKR='B' 



100000 
40000 
20000 
10000 
4000 
2000 
1000 
400 
200 
100 



TASK NOT IN EXECUTION (1=YES) 

I/O RUN DOWN IN PROGRESS (1=YES) 

ABORT MESSAGE BEING OUTPUT (1=YES) 

TASK MAPPED TO NONRESIDENT PARTITION (1=YES) 

TASK IS RUNNING ON ANOTHER PROCESSOR (1=YES) 

TASK HALF-LOADED BY TASK LOADER 

TASK EXTERNALLY BLOCKED VIA CLI COMMAND 

TASK IS OUT OF MEMORY (1=YES) 

TASK IS BEING CHECKPOINTED (1=YES) 

TASK CHECKPOINT REQUESTED (1=YES) 



+ 

TASK BLOCKING STATUS MASK 



TS . BLK= 1 B ' TS . CKP ! TS . CKR ! TS . EXE ! TS . MSG ! TS . NRP ! TS . OUT ! TS . RDN ! TS . STP 



+ 

SECOND STATUS WORD (STATE BITS) 



T2 


. AST = 


B ' 


100000 


'AST IN PROGRESS (1=YES) 


T2 


.DST= 


'B ' 


40000 


;AST RECOGNITION DISABLED (1=YES) 


T2 


.CHK = 


B ' 


20000 ; 


TASK NOT CHECKPOINTABLE (1=YES) 


T2 


.CKD = 


'B ' 


10000 


; CHECKPOINTING DISABLED (1=YES) 


T2 


,SEF = 


'B 1 


4000 


TASK STOPPED FOR EVENT FLAGS (1=YES) 


T2.FXD= 


'B' 


2000 


•TASK FIXED IN MEMORY (1=YES) 


T2 


.REX= 


'B' 


1000 


; ABORT AST EFFECTED OR IN PROGRESS (1=YES) 


T2 


.CAF = 


'B' 


400 


; DYN CHECKPOINT SPACE ALLOCATION FAILURE 


T2 


. HLT = 


'B' 


200 


;TASK IS BEING HALTED (1=YES) 


T2 


.ABO= 


'B' 


100 


; TASK MARKED FOR ABORT (1=YES) 


T2 


.STP = 


'B' 


40 


•SAVED T2.STP ON AST IN PROGRESS 


T2 


. STP = 


•B 1 


20 


; TASK STOPPED (1=YES) 


T2 


. SPN = 


'B' 


10 


;SAVED T2.SPN ON AST IN PROGRESS 


T2 


. SPN = 


'B' 


4 


; TASK SUSPENDED (1=YES) 


T2 


.WFR= 


'B' 


2 


•SAVED T2.WFR ON AST IN PROGRESS 


T2 


.WFR = 


'B' 


1 


; TASK IN WAITFOR STATE (1=YES) 



+ 

THIRD STATUS WORD (ATTRIBUTE BITS) 



T3. 


ACP= 


'B' 


100000 


ANCILLARY CONTROL PROCESSOR (1=YES) 


T3. 


PMD= 


'B' 


40000 


;DUMP TASK ON SYNCHRONOUS ABORT (0=YES) 


T3. 


REM= 


'B' 


20000 


•REMOVE TASK ON EXIT (1=YES) 


T3. 


PRV= 


'B' 


10000 


; TASK IS PRIVILEGED (1=YES) 


T3. 


MCR = 


'B' 


4000 


•TASK REQUESTED AS EXTERNAL MCR FUNCTION 










(1=YES) 


T3. 


SLV= 


'B' 


2000 


•TASK IS A SLAVE TASK (1=YES) 


T3. 


CLI = 


•B' 


1000 


; TASK IS A COMMAND LINE INTERPRETER (1=YES) 


T3. 


RST = 


'B' 


400 


TASK IS RESTRICTED (1=YES) 


T3. 


NSD = 


•B' 


200 


TASK DOES NOT ALLOW SEND DATA 
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T3. 


CAL = 


'B' 


100 


; TASK HAS CHECKPOINT SPACE IN TASK IMAGE 


T3. 


ROV= 


•B' 


40 


;TASK HAS RESIDENT OVERLAYS 


T3. 


NET = 


'B' 


20 


; NETWORK PROTOCOL LEVEL 


T3. 


GFL = 


'B' 


10 


;TASK HAS ITS GRP GBL EVENT FLAGS LOCKED 






•B' 


4 


; RESERVED FOR FUTURE USE 


T3. 


SWS = 


•B' 


2 


;RESERVED FOR USE BY SOFTWARE SERVICES 






•B' 


1 


; RESERVED FOR FUTURE USE 






. ENDC 







.PSECT 

.MACRO TCBDF$ X,Y,Z 
. ENDM 
. ENDM 



RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



UCBDFS 



. MACRO 



UCBDF $ , L , B , TTDEF , SYSDF 



UNIT CONTROL BLOCK 

THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL 
DEVICE UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE 
FIRST WORD OF AN ASSIGNED LUN . THERE IS ONE UCB FOR EACH DEVICE 
UNIT OF EACH DCB . THE UCB ' S ASSOCIATED WITH A PARTICULAR DCB ARE 
CONTIGUOUS IN MEMORY AND ARE POINTED TO BY THE DCB. UCB'S ARE 
VARIABLE LENGTH BETWEEN DCB ' S BUT ARE OF THE SAME LENGTH FOR A 
SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE ABOVE, EACH UNIT 
ON BOTH INTERFACES WOULD HAVE A UCB. 



.ASECT 

.IF NB SYSDF 
.IF DF E$$DVC 
.IF DF M$$MUP 



.=177766 

. IFF 
.=177770 

.ENDC 



;IS U.OWN THERE? 



u. 


IOC: 1 


L' 


.BLKW 


2 


;I/0 COUNT SINCE MOUNT 












; ONLY) 


u. 


ERSL: 


'L' 


. BLKB 


1 


;SOFT ERROR LIMIT 


u. 


ERHL : 


'L' 


.BLKB 


1 


;HARD ERROR LIMIT 


u. 


ERSC: 


'L' 


.BLKB 


1 


;SOFT ERROR COUNT 


u. 


ERHC: 


'L' 


.BLKB 


1 


; HARD ERROR COUNT 








.ENDC 












. ENDC 







.=177772 






U.MUP: ' L * 






U.CLI 


: 'L' 


.BLKW 


1 


U.LUIC: "L 1 


.BLKW 


1 


U.OWN 


: 'L' 


.BLKW 


1 


U.DCB: 'L' 


.BLKW 


1 


U . RED : ' L ' 


.BLKW 


1 


U.CTL: 'L' 


.BLKB 


1 


U.STS: 'L ' 


.BLKB 


1 


U.UNIT: 'L' 


.BLKB 


1 


U.ST2 


: ' L ' 


.BLKB 


1 


U.CW1 


: 'L' 


.BLKW 


1 


U.CW2 


'L' 


.BLKW 


1 


U.CW3 


'L' 


.BLKW 


1 


U.CW4 


'L ■ 


.BLKW 


1 


U.SCB 


: 'L' 


.BLKW 


1 


U. ATT 


:■[,' 


.BLKW 


1 


U.BUF 


• ' L ' 


.BLKW 


1 






.BLKW 


1 



MULTIUSER PROTECTION FLAG WORD 
TCB OF COMMAND LINE INTERPRETER 
LOGIN UIC - MULTI USER SYSTEMS ONLY 
OWNING TERMINAL - MULTI USER SYSTEMS 
ONLY 

BACK POINTER TO DCB 

POINTER TO REDIRECT UNIT UCB 

CONTROL PROCESSING FLAGS 

UNIT STATUS 

PHYSICAL UNIT NUMBER 

UNIT STATUS EXTENSION 

FIRST DEVICE CHARACTERISTICS WORD 

SECOND DEVICE CHARACTERISTICS WORD 

THIRD DEVICE CHARACTERISTICS WORD 

FOURTH DEVICE CHARACTERISTICS WORD 

POINTER TO SCB 

TCB ADDRESS OF ATTACHED TASK 
RELOCATION BIAS OF CURRENT I/O REQUEST 
BUFFER ADDRESS OF CURRENT I/O REQUEST 
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U.CNT: 1 L 1 
U.ACP='B * 
U.VCB='B' 
U.CBF='B ' 
U. KCSR= 'B 
U.KCS6='B 



. BLKW 1 
U.CNT+2 
U.CNT+4 
U.CNT+2 
U.CNT+2 
U.KCSR+2 



;BYTE COUNT OF CURRENT I/O REQUEST 
; ADDRESS OF TCB OF MOUNTED ACP 
; ADDRESS OF VOLUME CONTROL BLOCK 
;CONTROL BUFFER RELOCATION AND ADDRESS 
;CSR ADDRESS OF KMC-11 
;CSR+6 OF KMC-11 



MAGTAPE DRIVER DEFINITIONS 



U.SPC='B' U.CNT+6 
U.SUB='B I U.CNT+6 
U.FNUM='B' U.CNT+10 
U.FCDE= , B' U.CNT+12 



pSPACING COUNT 

; SUBCONTROLLER , PHYSICAL UNIT #, 
; FORMATTER NUMBER 
;FUNCTION CODE AND INDEX 



MSCP/TMSCP DRIVER UCB OFFSETS 
U.UTIL= , B I U.VCB+2 ;UNIT STATE WORD 

DEFINITIONS FOR U.UTIL BITS 

SERIAL MODE 
(DUDRV)RCT IN PROGRESS 

UNIT IS WAITING FOR OTHER UNITS TO SPIN 
DOWN 

UNIT MUST HAVE A GUS COMMAND ISSUED 
UNIT MUST HAVE A ONL COMMAND ISSUED 
SPECIAL ONLINE TRANSITION 
UNIT HAS SENT ATTENTION MESSAGE 
UNIT IS READY 

IF SET, XXCAN SET UU.SER FLAG FOR UNIT 
THIS UNIT CAN STALL I/O 
THIS UNIT HAS I/O STALLED 
MEDIA IDENTIFIER (2 WORDS) 

ALL THE FOLLOWING MSCP FIELDS APPLY ONLY TO DISK 

U.BPKT='B' U.VCB+10 ;UNIT BAD BLOCK PACKET WAITING LIST 

CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS 



UU.SER= 


'B' 


1 


UU.RCT= 


'B' 


2 


UU.AVN= 


'B' 


4 


UU.GUS= 


'B' 


10 


UU.ONL= 


'B' 


20 


UU.SPC= 


'B 1 


40 


UU.ATN= 


'B' 


100 


UU.RDY= 


'B' 


200 


UU.ABO= 


'B' 


400 


UU.SIO= 


•B' 


1000 


UU. IOS= 


'B' 


2000 


U.MEDI= 


'B' 


U. VCB+4 



U. 


MLUN= 


■B' 


U. 


VCB+14 


;MULTI-UNIT CODE 


U. 


UNFL = 


'B' 


U. 


VCB+16 


;UNIT FLAGS 


U. 


UNTI = 


■B' 


u. 


VCB+24 


;UNIT IDENTIFIER 


U. 


2MED = 


'B' 


u. 


VCB+34 


; ORIGINAL COPY OF MEDIA 


U. 


SHUN = 


•B' 


u. 


VCB+40 


; SHADOW UNIT 


U. 


SHST = 


•B' 


u. 


VCB+42 


; SHADOW UNIT STATUS 


U. 


TRCK= 


'B' 


u. 


VCB+4 4 


;UNIT TRACK SIZE 


U. 


GRP= ' 


B ' 


u. 


VCB+4 6 


;UNIT GROUP SIZE 


U. 


CYL=' 


B' 


u. 


VCB+50 


;UNIT CYLINDER SIZE 


U. 


USVR = 


•B' 


u. 


VCB+52 


;UNIT SOFTWARE VERSION 


U. 


UHVR = 


•B' 


u. 


VCB+53 


;UNIT HARDWARE VERSION 


U. 


RCTS = 


'B' 


u. 


VCB+54 


;UNIT RCT TABLE SIZE 


U. 


RBNS = 


'B' 


u. 


VCB+56 


;UNIT RBN 'S / TRACK 


u. 


RCTC = 


•B' 


u. 


VCB+57 


;UNIT RCT COPIES 
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; CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS" 
; END PACKETS 

U.UNSZ='B'U.VCB+60 ;UNIT SIZE 

U.VSER='B'U.VCB+64 ;VOLUME SERIAL NUMBER 



TERMINAL DRIVER DEFINITIONS 





U.BUF 








u. 


TUX: 'L ■ 


.BLKW 


1 


POINTER TO UCB EXTENSION (UCBX) 


u. 


TSTA : 1 L ' 


. BLKW 


4 , 


•STATUS QUADRUPLE -WORD 


u. 


TFRQ: 'L 1 


.BLKW 


1 j 


FORK REQUEST WORD 


u. 


TFLK: ' L 1 


.BLKW 


1 


FORK LIST LINK WORD 


u. 


TCHP: 'L ' 


.BLKB 


1 ; 


CURRENT HORIZONTAL POSITION 


u. 


TCVP: 1 L ' 


. BLKB 


1 


CURRENT VERTICAL POSITION 


u. 


UIC: 'L' 


.BLKW 


1 J 


TERMINAL UIC 


u. 


TTYP: ' L * 


.BLKB 


1 


TERMINAL TYPE 


u. 


TMTI : 1 L ' 


.BLKB 


1 j 


MODEM TIMER 


u. 


TTAB : ' L 1 


.BLKW 


1 , 


IF 0: U.TTAB+1 IS SINGLE-CHARACTER 



TYPE-AHEAD BUFFER, CURRENTLY EMPTY 
IF ODD: U.TTAB+1 IS SINGLE-CHARACTER 

TYPE-AHEAD BUFFER AND HOLDS A 

CHARACTER 
IF NON-0 AND EVEN: POINTER TO 

MULTI -CHARACTER TYPE-AHEAD BUFFER 



u 


.CTYP: 'L' 


.BLKB 


1 


[CONTROLLER TYPE 


u 


.TLPP: 'L 


.BLKB 


1 J 


LINES PER PAGE 


u 


. TST5: 'L 


.BLKW 


1 


[ADDITIONAL STATUS BITS 


u 


. TST6 : 'L' 


.BLKW 


1 


EXTENDED I/O STATUS BITS 


u 


.TIXL: 'L 


.BLKW 


1 


fl/O PACKET EXTENSION LISTHEAD 


u 


. ACB : 'L' 


.BLKW 


1 , 


ANCILLARY CONTROL DRIVER BLOCK ADDR 


u 


. AFLG: 'L 


.BLKW 


1 


; ANCILLARY CONTROL DRIVER FLAGS WORD 


u 


.ADMA: 'L 


.BLKW 


1 


ANCILLARY CONTROL DRIVER DMA BUFFER 




CONSOLE 


DRIVER 


DEFINITIONS 






=U.BUF+2 








u 


. CTCB : 1 L 


.BLKW 


1 ; ADDRESS OF CONSOLE LOGGER TCB 


u 


.COTQ: 'L 


.BLKW 


2 ;I/0 PACKET LIST QUEUE 


u 


. RED2 : 'L 


.BLKW 


1 ;REDIRECT UCB ADDRESS 



DEFINE BITS IN STATUS WORD 1 (U.TSTA) 



; I N P 


U T 


STATUS 




S1.RST= 


'B' 


1 


;READ WITH SPECIAL TERMINATORS IN 








; PROGRESS 


S1.ESC= 


'B' 


2 


; ESCAPE SEQUENCE IN PROGRESS 


S1.RSP= 


B' 


4 


;READ WITH SPECIAL PROCESSING 


S1.PTH= 


'B' 


10 


;PASS THRU IS CURRENTLY ACTIVE 


S1.RNE= 


'B' 


20 


;ECHO SUPPRESSED 


S1.TSY= 


'B' 


40 


;TERMINAL OUTPUT SYNC IS CURRENTLY 



; ENABLED 
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S1.0BY= 


'B ' 


100 


^OUTPUT BUSY 


SI. IBY= 


'B ' 


200 


; INPUT BUSY 


S1.DPR= 


'B* 


400 


DEFER PROCESSING OF CHAR. IN U.TECB 


S1.DEC= 


'B' 


1000 


; DEFER ECHO OF CHAR. IN U.TECB 


SI. IBF= 


'B' 


2000 


^BUFFERED INPUT IN PROGRESS 


S1.DSI= 


'B' 


4000 


'INPUT PROCESSING DISABLED 


S1.RES= 


'B' 


10000 


;ESC. SEQ PROCESSING IS ENABLED FOR THE 








CURRENT READ 


S1.RNF= 


'B' 


20000 


;READ NO FILTER IS ACTIVE (EDIT CHARS. 








ARE DISPLAYED) 


S1.TNE= 


'B' 


40000 


fTIPDM T XT 7\ mA r% KT /~\ T7» /■""» TT f\ 


SI. USI= 


'B' 


100000 


UNSOLICITED INPUT IN PROGRESS 


; DEFINE BITS IN STATUS WORD 




; o 


U T 


PUT STATU 


b 


S2.RCU= 


'B' 


1 


KriiaiUKEi L-UKbUK (rlUol — 1 r . KL.U ) 


S2.WRA= 


•B' 


6 


• PAMTII'YT PAD TaTDAD & DnnMn 
UUINIEjAI r UK WKAr-ftKUUNIJ 


S2.WRB= 


'B' 


2 J 


LUW Oil IN bZ.WKA oil FAIIUjKIN 


S2.WAL= 


•B' 


10 


, t»7 d T Tip n n ATT / M 1"T O Ti rriTTt t.t a r \ 


S2.BRQ= 


'B' 


20 


BREAK-THROUGH-WRITE REQUEST IN QUEUE 


S2.SRQ= 


'B' 


40 


or£jLXAL KJCiyUcjOl IN QU.EjU.ci 








(10. ATT, IO.DET, SF.SMC) 


S2.0RQ= 


'B' 


100 ; 


OUTPUT REQUEST IN QUEUE (MUST = S1.0BY) 


S2. IRQ= 


'B' 


200 ; 


INPUT KLQULbT IN QUEUE (MUbT = bl.IBY) 


S2.FLF= 


'B' 


400 


FORCE LINEFEED BEFORE NEXT ECHO 


S2 . ELF= 


•B' 


1000 


EAT A LINEFEED (IGNORE A LEADING LF ON 








OUTPUT) 


S2.CR='B' 


2000 


TRAILING CR REQUIRED ON OUTPUT 


S2.0BF= 


'B' 


4000 


•BUFFERED OUTPUT IN PROGRESS 


S2.PCU= 


'B' 


10000 


POSITION CURSOR BEFORE WRITE 


S2.BEL= 


1 B ' 


20000 


; BELL PENDING 


S2.CTO= 


'B' 


40000 


OUTPUT STOPPED BY CTRL-0 266. 


S2.CTS= 


'B ■ 


100000 ; 


OUTPUT STOPPED BY CTRL-S 



DEFINE BITS IN STATUS WORD 3 (U.TSTA+4) 
TERMINAL OPERATION CHARACTERISTICS 



S3. 


ACR= 


■B' 


1 


WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED 


S3. 


TAB= 


'B' 


2 


•TYPE-AHEAD BUFFER ALLOCATION REQUESTED 


S3. 


CTC = 


'B' 


4 


'TERMINAL WANTS CLI TO HAVE ~C NOTIFICATION 


S3. 


RAL = 


'B' 


10 


; TERMINAL IS IN READ-PASS-ALL MODE 


S3. 


NEC= 


'B' 


20 


•NO ECHO 


S3. 


TSY = 


'B' 


40 


^TERMINAL SYNC 


S3. 


8BC= 


'B' 


100 


'PASS 8 BITS ON INPUT 


S3. 


FDX = 


'B' 


200 


•LINE IS IN FULL DUPLEX MODE 


S3. 


MHE = 


•B' 


400 , 


NOTIFY ATTACHED TASK OF MODEM HANG-UP 


S3. 


ICE = 


'B' 


1000 


INPUT COUNT STATE ENABLED 


S3. 


TME = 


'B' 


2000 


•TERMINAL MANAGEMENT MODE ENABLED 


S3. 


PTH = 


'B' 


4000 


PASS THROUGH REQUESTED 


S3. 


RES = 


'B' 


10000 


TASK WANTS ESCAPE SEQUENCES 


S3. 


PPT = 


■B' 


20000 


^TERMINAL HAS PRINTER PORT 


S3. 


RUB = 


■B' 


40000 , 


RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE) 
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DEFINE BITS IN STATUS WORD 4 (U.TSTA+6) 



TERMINAL ATTRIBUTE CHARACTERISTICS 





TT T71 J" _ 

Mr L- 


1 Q 1 

£> 


"7 


HUKlZiUNlAL £ ILL Kdy U i KCiPlEiN 1 


S4. 


VFL = 


•B 1 


10 


; VERTICAL FILL REQUIREMENT 


S4. 


HFF = 


'B' 


20 


HARDWARE FORM-FEED PRESENT 


S4. 


HHT = 


•B' 


40 


; HARDWARE HORIZONTAL TAB PRESENT 


S4. 


DLO= 


•B 1 


100 


;DIAL-OUT LINE (IMPLIES U2.RMT) 


S4. 


HSY = 


'B' 


200 


; HOST/TERMINAL SYNCHRONIZATION ENABLED 










; (1=YES) 


S4. 


ANI = 


•B' 


400 


?ANSI CRT TERMINAL 


S4. 


AVO = 


'B' 


1000 


VT100-FAMILY TERMINAL DISPLAY 


S4. 


BLK = 


'B' 


2000 


;BLOCK MODE TERMINAL 


S4. 


DEC= 


'B' 


4000 


•DIGITAL CRT TERMINAL 


S4. 


EDT = 


'B 1 


10000 


•TERMINAL HAS LOCAL EDITING FUNCTIONS 


S4. 


RGS = 


'B' 


20000 


TERMINAL SUPPORTS REGIS GRAPHICS 


S4. 


SFC= 


•B' 


40000 


•TERMINAL SUPPORTS SOFT CHARACTERS (DRCS) 


S4. 


ABD= 


'B' 


100000 , 


AUTO-BAUD SPEED DETECTION ENABLED 



DEFINE BITS IN STATUS WORD U.TST5 
ADDITIONAL STATUS CHARACTERISTICS 



S5. 


SW1 = 


B 


1 


•FIRST TERMINAL MANAGEMENT SWITCH 










^CHARACTER HAS BEEN SEEN 


S5. 


TMM= 


B 


2 


'TERMINAL IN TERMINAL MANAGEMENT MODE 


S5. 


XOF = 


B 


4 


;SEND AN XOFF AT FIRST OPPORTUNITY 


S5. 


XON = 


B 


1 10 , 


SEND AN XON AT FIRST OPPORTUNITY 


S5. 


HPC = 


B 


14 


OUTPUT OF HIGH PRIORITY CHARACTERS 










REQUESTED 


S5. 


HPO = 


B 


' 20 


HIGH PRIORITY OUTPUT IN PROGRESS 


S5. 


OXF = 


B 


1 40 


•XOFF HAS BEEN OUTPUT 


S5. 


ITI = 


B 


100 


'IMMEDIATE TIMEOUT ON INPUT 


} 

S5. 


RPO= 


B 


1 2000 


;READ W/PROMPT OUTPUT IN PROGRESS 


S5. 


VER = 


B 


1 10000 


; LAST CHAR. IN TYPE-AHEAD BUFFER 










;HAS PARITY ERROR 


S5. 


BCC = 


'B 


• 20000 


LAST CHAR. IN TYPE-AHEAD BUFFER 










;HAS FRAMING ERROR 


S5. 


DAO = 


B 


' 40000 


; LAST CHAR. IN TYPE-AHEAD BUFFER 










•HAS DATA OVERRUN ERROR 










NOTE - THE 3 BITS ABOVE MUST CORRESPOND 










;TO THE RESPECTIVE ERROR FLAGS IN THE 










HARDWARE RECEIVE BUFFER 


S5. 


ABP= 


B 


1 100000 


AUTO-BAUD SPEED DETECTION IN PROGRESS 


; DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6 


S6. 


EIO = 


B 


' 400 ; READ WAS AN EXTENDED I/O 


S6. 


RLU== 


B 


' 1000 ; READ WITH LOWER CASE TO UPPER CASE 



SG.RDI^'B 1 100000 



CONVERSION 

; READ WITH DEFAULT INPUT 
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.PSECT 

+ 

DEVICE TABLE STATUS DEFINITIONS 

DEVICE CHARACTERISTICS WORD 1 (U.CWl) DEVICE TYPE DEFINITION BITS. 



DV.REC= 


'B' 


1 


RECORD ORIENTED DEVICE (1=YES) 




DV.CCL= 


'B' 


2 


^CARRIAGE CONTROL DEVICE (1=YES) 




DV. TTY= 


'B' 


4 , 


TERMINAL DEVICE (1=YES) 




DV.DIR= 


'B' 


10 


;FILE STRUCTURED DEVICE (1=YES) 




DV.SDI= 


'B' 


20 ; 


SINGLE DIRECTORY DEVICE (1=YES) 




DV.SQD= 


'B' 


40 


SEQUENTIAL DEVICE (1=YES) 




DV.MSD= 


•B' 


100 


MASS STORAGE DEVICE (1=YES) 




DV.UMD= 


'B' 


200 


USER MODE DIAGNOSTICS SUPPORTED (1 


=YES) 


DV.MBC= 


'B' 


400 


DEVICE IS ON MASSBUS CONTROLLER (1 


=YES) 


DV.EXT= 


■B' 


400 


DEVICE ON EXTENDED ADDRESSING CONTROLLER 


DV.SWL= 


B' 


1000 ; 


UNIT SOFTWARE WRITE LOCKED (1=YES) 




DV. ISP = 


'B' 


2000 , 


INPUT SPOOLED DEVICE (1=YES) 




DV.OSP= 


B' 


4000 


OUTPUT SPOOLED DEVICE (1=YES) 




DV.PSE= 


'B' 


10000 


PSEUDO DEVICE (1=YES) 




DV.COM= 


'B' 


20000 


DEVICE IS MOUNTABLE AS COM CHANNEL 










(1=YES) 




DV.F11= 


'B ■ 


40000 ; 


DEVICE IS MOUNTABLE AS Fll DEVICE 


(1=YES) 


DV. MNT= 


'B' 


100000 


DEVICE IS MOUNTABLE (1=YES) 





; TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2. 


DH1 = 


'B' 


100000 


UNIT IS A MULTIPLEXER (1=YES) 


U2. 


DJ1 = 


'B' 


40000 


;UNIT IS A DJ11 (1=YES) 


U2. 


RMT = 


'B' 


20000 


UNIT IS REMOTE (1=YES) 


U2. 


HFF = 


•B' 


10000 


■UNIT HANDLES HARDWARE FORM FEEDS (1=YES) 


U2. 


L8S = 


'B' 


10000 


OLD NAME FOR U2.HFF 


U2. 


NEC = 


'B' 


4000 


■DON'T ECHO SOLICITED INPUT (1=YES) 


U2. 


CRT = 


'B 1 


2000 


UNIT IS A CRT (1=YES) 


U2. 


ESC = 


'B' 


1000 


UNIT GENERATES ESCAPE SEQUENCES (1=YES) 


U2. 


LOG= 


B' 


400 


USER LOGGED ON TERMINAL (0=YES) 


U2. 


SLV= 


'B' 


200 


UNIT IS A SLAVE TERMINAL (1=YES) 


U2. 


DZ1 = 


B' 


100 


UNIT IS A DZ11 (1=YES) 


U2. 


HLD = 


'B' 


40 


TERMINAL IS IN HOLD SCREEN MODE (1=YES) 


U2. 


AT . = 


'B ' 


20 


MCR COMMAND AT. BEING PROCESSED (1=YES) 


U2. 


PRV= 


'B' 


10 


UNIT IS A PRIVILEGED TERMINAL (1=YES) 


U2. 


L3S = 


B' 


4 


UNIT IS A LA30S TERMINAL (1=YES) 


U2. 


SCS = 


•B' 


4 


;SCS-11 COMMAND TERMINAL (1=YES) 


U2. 


VT5= 


■B' 


2 


UNIT IS A VT05B TERMINAL (1=YES) 


U2. 


LWC = 


'B' 


1 


; LOWER CASE TO UPPER CASE CONVERSION 



(0=YES) 



; + 

; BIT DEFINITIONS FOR U.MUP (SYSTEMS WITH ALTERNATE CLI SUPPORT ONLY) 
f — 
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UCBDF$ (Cont.) 



UM. 


OVR== 


'B' 


1 


; OVERRIDE CLI INDICATOR 


UM. 


CLI== 


'B' 


36 


;CLI INDICATOR BITS 


UM. 


DSB== 


'B 1 


200 


; TERMINAL DISABLED SINCE 


UM. 

; + 


NBR== 


'B' 


400 


;NO BROADCAST 



RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2.R04=='B' 100000 
+ 



;UNIT IS A RS04 (1=YES) 
RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2.7CH:='B' 10000 
+ 



;UNIT IS A 7 CHANNEL DRIVE (1=YES) 
TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS 



U3.UPC='B' 20000 
U3.PAR='B I 40000 
U3.0PA= I B' 100000 



;UPCASE OUTPUT FLAG 

; PARITY GENERATION AND CHECKING 

; PARITY SENSE (l=ODD PARITY) 



TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS 



U4.CR='B' 100 
+ 



;LOOK FOR CARRIAGE RETURN 



UNIT CONTROL PROCESSING FLAG DEFINITIONS 



UC.ALG='B 1 
UC.NPR='B' 
UC.QUE='B' 
UC.PWF-'B' 
UC . ATT= 'B 1 
UC.KIL^'B' 
UC.LGH='B I 



200 
100 
40 
20 
10 
4 
3 



;BYTE ALIGNMENT ALLOWED (l=NO) 
;DEVICE IS AN NPR DEVICE (1=YES) 
;CALL DRIVER BEFORE QUEUING (1=YES) 
;CALL DRIVER AT POWERFAIL ALWAYS (l=YESi 
;CALL DRIVER ON ATTACH/DETACH (1=YES) 
;CALL DRIVER AT I/O KILL ALWAYS (1=YES) 
; TRANSFER LENGTH MASK BITS 



UNIT STATUS BIT DEFINTIONS 



US.BSY='B' 
US.MNT= 'B • 
US.FOR='B' 
US ,MDM= ' B 1 
US.PWF='B ' 



200 
100 
40 
20 
10 



;UNIT IS BUSY (1=YES) 
;UNIT IS MOUNTED (0=YES) 

;UNIT IS MOUNTED AS FOREIGN VOLUME (1=YES) 
;UNIT IS MARKED FOR DISMOUNT (1=YES) 
; POWERFAIL OCCURRED (1=YES) 



CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS 



US.ABO='B' 1 
US.MDE='B' 2 



;UNIT IS MARKED FOR ABORT IF NOT READY 
; (1=YES) 

;UNIT IS IN 029 TRANSLATION NODE (1=YES) 
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UCBDFS (Cont.) 



FILES-11 DEPENDENT UNIT STATUS BITS 



US.WCK='B' 10 
US.SPU='B' 2 
US. VV= 'B ' 1 



;WRITE CHECK ENABLED (1=YES) 
;UNIT IS SPINNING UP (1=YES) 
; VOLUME VALID IS SET (1=YES; 



KMC-11-LP DEPDENDENT UNIT STATUS BITS 



US.KPF='B' 
+ 



;KMC-11 POWERFAIL INTERLOCK 



TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS 

.IF NB TTDEF 
.IF DF T$$CPW 



US.CRW='B ' 
US.DSB='B' 
US.OIU='B l 



. IFF 



US.DSB='B' 10 

US.CRW='B' 4 

US.ECH='B' 2 

US.OUT= , B' 1 



. ENDC 



. ENDC 



;UNIT IS WAITING FOR CARRIER (1=YES) 
;UNIT IS DISABLED (1=YES) 

;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT 
; (1=YES) 

;T$$CPW 

;UNIT IS DISABLED (1=YES) 
;UNIT IS WAITING FOR CARRIER (1=YES) 
;UNIT HAS ECHO IN PROGRESS (1=YES) 
;UNIT IS EXPECTING OUTPUT INTERRUPT 
; (1=YES) 



;TTDEF 



LPS11 DEPENDENT UNIT STATUS BIT DEFINITIONS 



US.FRK='B' 2 
US.SHR='B' 1 



;FORK IN PROGRESS (1=YES) 

; SHAREABLE FUNCTION IN PROGRESS (0='B'YES) 



MAGTAPE DEPENDENT UNIT STATUS BITS 



US.LAB='B' 4 
US.BSP='B' 2 



; UNIT HAS LABELED TAPE ON IT (1=YES) 

; INTERNAL BACKSPACE IN PROGRESS (1=YES) 



UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS 
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US.OFL='B' 1 

US.RED='B' 2 

US.PUB='B' 4 

US.UMD='B I 10 



;UNIT OFFLINE (1=YES) 

;UNIT REDIRECTABLE (0=YES) 

;UNIT IS PUBLIC DEVICE (1=YES) 

;UNIT ATTACHED FOR DIAGNOSTICS (1=YES) 



MAG TAPE DENS SUPPORT IDENT IN CHAR WORD 3 (U.CW3) DEFENITION 
ASSIGNMENTS PER NUMERICAL SEQUENCE - 255. 



UD.UNS='B' 
UD. 200= , B' 
UD.556='B' 
UD.800='B' 
UD. 160= 'B 1 
UD.625='B' 
UD.8K='B' 



UNSUPPORTED 



200BPI, 
556BPI , 
800BPI , 
1600BPI, 
6250BPI , 



TRACK 
TRACK 

OR 9 TRACK 

TRACK 

TRACK 



8K BPI - SERIAL, SERPENTINE RECORDING 



.MACRO UCBDF$, X, Y, Z, ZZ 
., ENDM 
., ENDM 
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This appendix describes the RSX-11M-PLUS system macros that supply 
symbolic offsets for data structures listed in Table C-l. 

The data structures are defined by macros in the Executive macro 
library. To reference any of the data structure offsets from your 
code, include the macro name in an .MCALL directive and invoke the 
macro. For example: 



. MCALL DCBDF$ 
DCBDF$ 



;Define DBC offsets 



NOTE 

All physical offsets and bit definitions are subject 
to change in future releases of the operating system. 
Code that accesses system data structures should 
always use the symbolic offsets rather than the 
physical offsets. 



The first two arguments, <:> and <=>, make all definitions global. If 
they are left blank, the definitions will be local. 

All of these macros are in the Executive macro library 
LB : [ 1 , 1 ] E XEMC . MLB . All except FllDF$, ITBDF$, MTADF$, OLRDF$, and 
SHDDF$ are also in the Executive definition library 
LB: [1,1]EXELIB.0LB. 



Table C-l 

Summary of System Data Structure Macros 



Macro Arguments 



Data Structures 



ABODF$ <:>,<=> 
ACNDF$ <:>,<=> 

CLKDF$ <:>,<=> 
CTBDF$ <:>,<=> 



Task abort and termination 
notification message codes 

Accounting data structures (user 
account block, task account 
block, system account block) 

Clock queue control block 
Controller table 



(Continued on next page) 
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Table C-l (Cont.) 
Summary of System Data Structure Macros 



Macro Arguments Data Structures 



DCBDF$ 


< : 




> 


Device Control Block 


EPKDF$ 


< : 




> 


Error message block 


EVNDF$ 


<: 


>,< = 


> 


Terminal Software Architecture 

^ 1 U ti 1 d V " 11 L KJ d V— t_ C J- X 1] 1 U 1 UNO 


F11DF$ 


< : 




> 


FILES-11 data structures (Volume 
Control Block, mount list entry. 
File Control Block, file window 
block, locked block list node) 


HDRDF$ 


<: 


>,< = 


> 


Task header and window block 


HWDDF$ 


<: 


>,< = 


> 


Hardware register addresses and 
feature mask definitions 


ITBDF$ 


<: 


>,< = 


> 


Interrupt transfer block 


KRBDFS 


< ; 


> < = 


> 


fontrnl 1 p»t vpniip^t - hi rifle 


LCBDF$ 


<: 


>,< = 


> 


Logical assignment control block 


MTADF$ 


<: 


>,< = 


> 


ANSI magtape data structures 
(volume set control block) 


OLRDF$ 








On-line reconfiguration interface 


PCBDF$ 


<: 


>,< = 


> 


Partition Control Block and 
attachment descriptor 


PKTDF$ 


<: 




> 


I/O packet, AST control block, 
offspring control block, group 
global event flag control block, 
and CLI parser block 


SCBDF$ 


<: 


>,< = 


> 


Status Control Block and UMR 
assignment block 


SHDDF$ 


<: 


>,< = 


> 


Shadow recording linkage block 


TCBDF$ 


<: 


>,< = 


> 


Task Control Block 


UCBDF$ 


<: 


>,< = 


> , TTDEF 


Unit Control Block 



C-2 



RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



ABODFS 



.MACRO ABODF$,L,B 
TASK ABORT CODES 

NOTE: S.COAD-S .CFLT ARE ALSO SST VECTOR OFFSETS 



o • U I - 


B 


-4 . 


S . CEXT= 


B 


- Z . 


S .COAD= 


B 


. 


S.CSGF= 


'B 


2. 


S.CBPT= 


B 


4. 


S .CIOT= 


B 


r 

D . 


S ,CILI= 


B 


o 

O . 


S ,CEMT= 


'B 


10 . 


S.CTRP= 


B 


12. 


S.CFLT= 


'B 


14. 


S.CSST= 


B 


16. 


S.CAST= 


'B 


18. 


S.CABO= 


'B 


20. 


S.CLRF= 


'B 


22. 


S.CCRF= 


'B 


24. 


S.IOMG= 


•B 


26. 


S.PRTY= 


'B 


28. 


S.CPMD= 


*B 


30. 


S.CELV= 


'B 


32. 


S.CINS= 


»B 


'34. 


S.CAFF= 


'B 


36. 


S.CCSM= 


•B 


'38. 


S.COTL = 


•B 


'40. 


S.CTKN= 


"B 


'42. 



TASK STILL ACTIVE 

TASK EXITED NORMALLY 

ODD ADDRESS AND TRAPS TO 4 

SEGMENT FAULT 

BREAK POINT OR TRACE TRAP 

IOT INSTRUCTION 

ILLEGAL OR RESERVED INSTRUCTION 
NON RSX EMT INSTRUCTION 
TRAP INSTRUCTION 

11/40 FLOATING POINT EXCEPTION 

SST ABORT-BAD STACK 

AST ABORT -BAD STACK 

ABORT VIA DIRECTIVE 

TASK LOAD REQUEST FAILURE 

TASK CHECKPOINT READ FAILURE 

TASK EXIT WITH OUTSTANDING I/O 

TASK MEMORY PARITY ERROR 

TASK ABORTED WITH PMD REQUEST 

TI: VIRTUAL TERMINAL WAS ELIMINATED 

TASK INSTALLED IN 2 DIFFERENT SYSTEMS 

TASK ABORTED DUE TO BAD AFFINITY (REQUIRED 

BUS RUNS ARE OFFLINE OR NOT PRESENT) 

BAD CSM PARAMETERS OR BAD STACK 

TASK HAS RUN OVER ITS TIME LIMIT 

ABORT VIA DIRECTIVE WITH NO TKTN MESSAGE 



TERMINATION CODES FOR BOM$ 
NOTE: 

THE NORMAL TKTN ERROR CODES SPAN -4 THROUGH 42. THE BOM CODES, 
ALTHOUGH DEFINED FOR THE TASK, ETC, AS THROUGH N, ARE PASSED TO 
TKTN AS -127 THROUGH -127+N. AN UNRECOGNIZED CODE IS PASSED AS -128, 
UNKNOWN ERROR. 



S.BUNK='B'-128. 

S.BFEI="B , 0. 

S.BOVL='B l l. 



; UNKNOWN BOM$ ERROR 

; ERROR IN HIGH LEVEL LANGUAGE INTERFACE 
; LOAD OVERLAY FAILURE 



KEEP THE FOLLOWING DEFINED AS THE HIGHEST CODE IN USE 



S .BHI='B ' 1. 



; HIGHEST ACCEPTABLE BOM$ CODE 



BIT DEFINITIONS FOR BOM$ FLAGS WORD 
S.BBIF='B'l. ; ENABLE CONDITIONAL BREAKPOINT 
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ABODFS (Cont.) 



TASK TERMINATION NOTIFICATION MESSAGE CODES 



T 


. NDNR= 


'B 


'0 


^DEVICE NOT READY 


T 


. NDSE= 


'B 


2 


^DEVICE SELECT ERROR 


T 


.NCWF= 


'B 


4 


CHECKPOINT WRITE FAILURE 


T 


. NCRE = 


'B 


6 


;CARD READER HARDWARE ERROR 


T 


. NDMO= 


'B 


8. 


•DISMOUNT COMPLETE 


T 


. NUER= 


'B 


'10. 


; UNRECOVERABLE ERROR 


T 


. NLDN= 


'B 


12. , 


LINK DOWN (NETWORKS) 


T 


.NLUP= 


*B 


14 . 


; LINK UP (NETWORKS) 


T 


.NCFI= 


'B 


16. 


CHECKPOINT FILE INACTIVE 


T 


. NUDE= 


•B 


18. 


•UNRECOVERABLE DEVICE ERROR 


T 


. NMPE= 


'B 


20. 


MEMORY PARITY ERROR 


T 


. NKLF= 


'B 


22. 


UCODE LOADER NOT INSTALLED 


T 


. NAAF= 


B 


24. 


ACCOUNTING ALLOCATION FAILURE 


T 


. NTAF= 


•B 


26. 


^ACCOUNTING TAB ALLOCATION FAILURE 


T 


. NDEB= 


B 


28. 


TASK HAS NO DEBUGGING AID 


T 


. NRCT= 


'B 


30. 


•REPLACEMENT CONTROL TASK NOT INSTALLED 


T 


. NWBL= 


B 


32. 


WRITE BACK CACHING DATA LOST 










UNIT WRITE LOCKED 


T 


. NVER= 


'B 


34. \ 


MOUNT VERIFICATION TASK NOT INSTALLED 


T 


.NIOS= 


'B 


36. 


I/O STALLED TO DEVICE 


T 


.NIOR= 


B 


38. ; 


I/O RESUMING ON DEVICE 



.MACRO ABODF$ X,Y 
• ENDM 
. ENDM 
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ACNDF$ 



.MACRO ACNDF$,L,B 

+ 

ACCOUNTING BLOCK OFFSET AND STATUS DEFINITIONS 
FOR EACH TRANSACTION TYPE. 

HEADER COMMON TO ALL TRANSACTIONS 



.ASECT 

.=0 



B.LNK: 


'L' 


.BLKW 


1 


LINK TO NEXT IN SYSLOG QUEUE 


B.TYP: 


'L' 


. BLKB 


1 


TRANSACTION TYPE 


B.LEN: 


•L' 


.BLKB 


1 


TRANSACTION LENGTH 


B.TIM: 


'L' 


. BLKW 


3 


ENDING TIME OF TRANSACTION 


B.HID= 


'B' 






START OF HEADER IDENTIFICATION AREA 


B.UID: 


*L' 


.BLKW 


2 , 


UNIQUE SESSION IDENT 
FIRST WORD-RAD50 , SECOND-BINARY 


B.ACN: 


'L' 


.BLKW 


1 


^ACCOUNT NUMBER 


B.TID: 


'L' 


.BLKB 


1 ; 


ASCII TERMINAL TYPE (V,T,B OR C) 
(VIRTUAL , REAL , BATCH , OR CONSOLE) 






.BLKB 


1 


; UNIT NUMBER 


B.HEND 


= 'B 


i 




END OF HEADER ID AREA 


$$$HLN 








HEADER LENGTH 



ACCUMULATION FIELDS FOR TAB, UAB , AND SAB 



B.CPU: 


' L * 


.BLKW 


2 


B.DIR: 


•L' 


.BLKW 


2 


B.QIO: 


■L' 


.BLKW 


2 


B.TAS: 


•L' 


.BLKW 


2 


B.MEM: 


•L' 


.BLKW 


3 


B.BEG: 


•L' 


.BLKW 


3 


B.CPUL 


: 'L 


' .BLKW 


2 


B.PNT: 


'L 1 


.BLKW 


1 


B.STM: 


'L' 


.BLKB 


1 


$$$TLN 









TOTAL CPU TIME USED 
TOTAL DIRECTIVE COUNT 
TOTAL QIO$ COUNT 
TOTAL TASK COUNT 
RESERVED 

BEGINNING/LOGIN TIME 
CPU LIMIT 

POINTER TO HIGHER LEVEL TOTALS 
STATUS MASK 
TOTAL'S LENGTH 



USER ACCOUNT BLOCK (UAB) 

NOTE: UAB'S MUST END ON A WORD BOUNDRY 



.=$$$TLN 

B. USE: 'L' .BLKB 1 

B. ACT: 'L' .BLKW 1 

B.UUIC: 1 L' .BLKW 1 

B.UCB: 'L ' .BLKW 1 

B.LGO: 'L' .BLKW 3 

B.ULNK: 'L' .BLKW 1 

B.RNA: 'L' .BLKW 3 



START AFTER TOTALS 
USE COUNT 

NUMBER OF CURRENTLY ACTIVE TASKS 

LOGIN UIC 

POINTER TO UCB 

LOGOFF TIME 

LINK TO NEXT UAB 

LOC IN SYSTEM ACCNT FILE 

(OFFSET, VBN-HI ,VBN-LO) 
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ACNDF$ (Cont.) 



B.NAM: 1 L ' . BLKB 14. 

. BLKB 1 

.BLKB 1 
B.LDS: 'L ' .BLKB 10. 
B.ULEN= 'B' . 
$$$= <.+77>/100 

; + 

; TASK ACCOUNT BLOCK (TAB) 

; NOTE: THE TAB MUST END ON A WORD BOUNDARY 





=$$$TLN 






; STARTS AFTER TOTALS 


B 


.PRI : 'L' 


.BLKB 


1 


; HIGHEST RUNNING PRIORITY 


B 


. TNAM : ' L 


' . BLKW 


2 


; TASK NAME 


B 


. TCB : 'L' 


. BLKW 


1 


;TCB ADDRESS 


B 


. TST3 : 'L 


' .BLKW 


1 


; T.ST 3 FROM TASK'S TCB 






.BLKW 


1 


; RESERVED FOR FUTURE STATUS BITS 


B 


.CUIC: f L 


1 .BLKW 


1 


;CURRENT UIC OF TASK 


B 


.PUIC: 'L 


' .BLKW 


1 


; PROTECTION UIC OF TASK 


B 


.CTXT: 'L 


' .BLKW 


2 


; NUMBER OF CONTEXT LOADS 


B 


.TCKP: 'L 


1 .BLKW 


2 


; TIMES TASK HAS BEEN CHECKPOINTED 


B 


. OVLY : ' L 


' .BLKW 


2 


; NUMBER OF DISK OVERLAY LOADS 


B 


.EXST: 'L 


1 .BLKW 


2 


;EXIT STATUS AND ABORT CODE 


B 


. TLEN= 1 B 


i 




; TAB LENGTH 


B 


.TBLK='B 


'<.+77>/100 


; NUMBER OF SEC POOL BLOCKS IN TAB 



+ 

SYSTEM ACCOUNT BLOCK (SAB) 





=$$$TLN 






; START AFTER TOTALS 


B 


. SHDN 


'L 


' .BLKB 


1 


;ACCOUNTING SHUTDOWN REASON CODE 


B 


. UHD : 


L' 


.BLKW 


1 


;UAB LISTHEAD 


B 


.ULO: 


'L' 


.BLKW 


1 


; NUMBER OF USERS CURRENTLY LOGGED ON 


B 


.ULT: 


L' 


.BLKW 


2 


; TOTAL NUMBER OF LOGONS 


B 


.CKP: 


•L' 


.BLKW 


2 


; TOTAL NUMBER OF CHECKPOINTS 


B 


. SHF : 


L' 


.BLKW 


2 


; TOTAL NUMBER OF SHUFFLER RUNS 


B 


. RND : 


'L' 


.BLKW 


2 


; NUMBER OF CPU INTERVALS ROUNDED UP TO 


B 


.FID: 


'L' 


.BLKW 


3 


;FILE-ID OF TRANSACTION FILE 


B 


. DVNM 


: 'L 


' .BLKB 


2 


; DEVICE OF TRANSACTION FILE 


B 


.UNIT 


: 'L 


1 .BLKW 


1 


;UNIT OF TRANSACTION FILE 


B 


.EXTS 


'L 


' .BLKW 


1 


; EXTEND SIZE FOR TRANSACTION FILE 


B 


. LSCN 


'L 


' .BLKW 


3 


;TIME OF LAST SCAN 


B 


.SCNR 


•L 


' .BLKW 


1 


;SCAN RATE IN SECONDS 


B 


.DSCN 


•L 


' .BLKW 


1 


STATISTICAL SCAN RATE (IN SEC) 


B 


.STSP 


•L 


1 .BLKW 


2 


; RESERVED 


B 


.SYSM 


. 'L 


' .BLKW 


1 


; RESERVED 


B 


.CKUS 


: 'L 


' .BLKW 


3 


; RESERVED 


B 


.CKSP 


'L 


1 .BLKW 


2 


; RESERVED 


B 


.CKAL 


: 'L 


' .BLKW 


1 


; RESERVED 


B 


. SLEN = 


= 'B 


i 




;SAB LENGTH 



; NEW FIELDS FOR EXTENDED ACCOUNTING 



; LAST NAME OF USER 
;FIRST INITIAL OF USER 
; FLAG BYTE FOR UAB (bs.sil) etc. 
;LOGIN DIRECTORY STRING 
;UAB LENGTH 

;UAB LENGTH (ROUNDED UP TO 32 WORD BOUND) 
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ACNDFS (Cont.) 



B.CPUT 


'L 1 


.BLKW 


8 . 


B.CTXP 


: 'L ' 


.BLKW 


8 . 


B. IDCT 


'L ' 


. BLKW 


8. 


B.QIOC 


1 L ' 


.BLKW 


8. 


B.MIOC 


' L ' 


.BLKW 


8. 


B.AIOC 


'L 1 


.BLKW 


8. 


B. IPSN 


'L 1 


.BLKW 


8. 


B . I PRC 


' L 1 


.BLKW 


8. 


B.CKEX: 


' L 1 


.BLKW 


2 


B.CFCL: 


•L' 


.BLKW 


2 


B.CFRK 


1 L ' 


.BLKW 


2 


B.TLOD 


1 L 1 


.BLKW 


2 


B.RLOD. 


•L' 


.BLKW 


2 






.BLKB 


82. 


B.SSBL= 


= .-B 


.SLEN 




$$$ = 


<. 


+77>/100 



CPU TIME USED PER PROCESSOR 

NUMBER OF CONTEXT SWITCHES (PER PROC) 

NUMBER OF IDLE LOOP ENTRIES (PER PROC) 

NUMBER OF I/O INITIATIONS (PER PROC) 

MASS STORE I/O COMPLETIONS (PER PROC) 

ALL I/O COMPLETIONS (PER PROC) 

IP INTERRUPTS SENT (PER PROC) 

IP INTERRUPTS RCVD (PER PROC) 

CHECKPOINT DUE TO EXTEND TASKS 

CALLS TO CFORK 

CFORK FORKS 

TASK LOADS 

REGION LOADS 

BUMP SIZE TO NEXT 32 WORD BLOCK 

EXTRA LENGTH OF SYSTEM STATISTICS BLOCK 

SAB LENGTH (ROUNDED UP TO 32 WORD BOUND) 



SYSLOG STARTUP TRANSACTION 



$$$HLN 
B.SSLN='B' 



; START AFTER HEADER 
; TRANSACTION LENGTH 



CRASH RECOVERY TRANSACTION 



$$$HLN 
B.CTLS: 'L' .BLKW 3 
B.CSRT: 'L' .BLKW 1 
B.CRSN: 'L' .BLKB 60. 
B.CLEN= 'B 1 . 



; START AFTER STANDARD HEADER 

; TIME OF LAST SCAN BEFORE CRASH 

;SCAN RATE BEFORE CRASH 

; ASCI I TEXT EXPLAINING CRASH 

TRANSACTION LENGTH 



INVALID LOGIN TRANSACTION 



$$$HLN 
B.I NAM : 'L' .BLKB 14. 
B. IUIC: 'L 1 .BLKB 6 . 
B . IPSW: 'L 1 .BLKB 6. 
B . ILEN= 1 B ' . 



; NAME FROM LOGIN LINE 
;UIC FROM LOGIN LINE 
; PASSWORD FROM LOGIN LINE 
; TRANSACTION LENGTH 



DEVICE TRANSACTIONS (ALLOCATION, DEALLOCATION, MOUNT, AND DISMOUNT) 



$$$HLN 
B.DNAM: 'L' .BLKW 1 
B.DUNT: 'L' .BLKB 1 
B.DLEN='B' . 

.BLKB 1 



; ASCI I DEVICE NAME 

; OCTAL DEVICE UNIT NUMBER 

; TRANSACTION LENGTH FOR ALL, DEA, AND DMO 
; UNUSED BYTE 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



ACNDF$ (Cont.) 



B.DLBL: 'L' .BLKW 6 
B.DMST: 1 L 1 .BLKW 1 
B.DUIC: 'L' .BLKW 1 
B.DVPR: 'L' .BLKW 1 
B.DACP: 'L' .BLKW 2 
B.MLEN= 'B' . 



; VOLUME LABEL 
;MOUNT STATUS BITS 
; OWNER UIC 

; VOLUME PROTECTION CODE 
; NAME OF ACP FOR DEVICE 
; LENGTH OF MOUNT TRANSACTION 



STATUS BITS FOR MOUNT STATUS MASK (B.DMST) 



BM.SHR='B'l 
BM.NOS= 'B 1 2 
BM.SYS='B'4 
BM.FOR= , B , 10 



; DEVICE IS MOUNTED SHARED 

;DEVICE IS MOUNTED NOSHARE 

;DEVICE IS MOUNTED FOR THE SYSTEM (PUBLIC) 

;DEVICE IS MOUNTED FOREIGN 



SYSTEM TIME CHANGE TRANSACTION 



$$$HLN 
B.TOLD: 'L' .BLKB 6 
B.TNEW: 'L 1 .BLKB 6 
B . TMLN= ' B 1 . 



OLD TIME (YR, MON , DAY, HR, MIN, SEC) 
NEW TIME (YR, MON, DAY, HR, MIN, SEC) 
TRANSACTION LENGTH 



+ 

PRINT DESPOOLER TRANSACTION 







$$$HLN 




; START AFTER HEADER 


B. 


PNAM: 


•L' 


.BLKW 


3 


; PRINT JOB NAME ( RAD 5 ) 


B. 


PPGS : 


'L' 


.BLKW 


1 


; PAGE COUNT 


B. 


PNFI : 


■L' 


.BLKW 


1 


; NUMBER OF FILES PRINTED 


B. 


PFRM: 


•L' 


.BLKB 


1 


;FORM NUMBER 


B. 


PPRI : 


'L' 


.BLKB 


1 


;PRINT PRIORITY 


B. 


PDEV: 


•L' 


.BLKW 


1 


; PRINT DEVICE NAME (ASCII) 


B. 


PPUN: 


•L 1 


.BLKB 


1 


;UNIT NUMBER OF PRINT DEVICE 


B. 


PLEN= 


'B' 






; TRANSACTION LENGTH 



CARD READER SPOOLING TRANSACTION 



$$$HLN 
B.RNAM: 'L' .BLKW 3 
B.RCDS: 'L' .BLKW 1 
B.RDEV: 'L' .BLKW 1 
B.RUNT: 'L 1 .BLKB 1 
B.RSOP: 'L' .BLKB 1 
B.RLEN= *B 1 . 



; START AFTER HEADER 

; BATCH OR PRINT JOB NAME 

; NUMBER OF CARDS READ 

; READER DEVICE NAME (ASCII) 

;UNIT NUMBER OF READER DEVICE 

;SUBMIT OR PRINT (0=SUBMIT, 1=PRINT) 

TRANSACTION LENGTH 



+ 

LOGIN TRANSACTION 
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ACNDF$ (Cont.) 



$$$HLN 
B.LUIC: 'L ' .BLKW 1 
B.LNAM: ' L ' .BLKB 14. 

.BLKB 1 
B . LLEN= *B ' . 



; START AFTER HEADER 
;LOGIN UIC 
; USER'S LAST NAME 
; AND FIRST INITIAL 
TRANSACTION LENGTH 



+ 

RESET TRANSACTION PARAMETERS 





=$$$HLN 






B 


.OFID 


• 'L' 


.BLKW 


3 


B 


. ODNM 


' 'L' 


.BLKB 


2 


B 


.OUNT 


•L" 


.BLKW 


1 


B 


. NFID 


'L' 


.BLKW 


3 


B 


.NDNM 


'L' 


.BLKB 


2 


B 


. NUNT 


: 'L' 


.BLKW 


1 


B 


.OEXS' 


'L' 


.BLKW 


1 


B 


.NEXS 


'L' 


.BLKW 


1 


B 


.OSCR 


'L' 


.BLKW 


1 


B 


.NSCR 


: 'L' 


.BLKW 


1 


B 


.ODSC 


: 'L' 


.BLKW 


1 


B 


.NDSC 


'L' 


.BLKW 


1 


B 


. RTLN= 


= *B' 







AFTER HEADER 

FILE-ID OF OLD TRN. FILE 
DEVICE OF OLD TRN. FILE 
UNIT OF OLD TRN. FILE 
FILE-ID OF NEW TRN. FILE 
DEVICE OF NEW TRN. FILE 
UNIT OF NEW TRN. FILE 
EXT. SIZE FOR OLD TRN. FILE 
EXT. SIZE FOR NEW TRN. FILE 
OLD SCAN RATE IN SECONDS 
NEW SCAN RATE IN SECONDS 
OLD STATISTICAL SCAN RATE 
NEW STATISTICAL SCAN RATE 



+ 

TRANSACTION TYPES 



000 THRU 127 RESERVED FOR DEC USE 

128 THRU 255 RESERVED FOR CUSTOMER USE 



BT .SAB 
BT . UAB 
BT . TAB 
BT.SS= 
BT.INV 
BT .TIM 
BT .ALL 
BT.DEA 
BT.MOU 
BT . DMO 
BT . PRT 
BT.DIR 



= "B'l 
= "B'2 
= "B'3 
•B'll 
="B , 12 
= 1 B , 13 
="B'14 
= 'B'15 
="B'16 
= 'B'17 
= ' , B , 20 
= 'B'21 



BT.VOL= 'B'22 

BT . LOG= 'B'23 
BT.CRH="B , 24 
BT . DST= 'B'25 
BT .RTP= "B ' 26 
BT.INP='B'27 



SYSTEM ACCOUNT BLOCK (SAB) 
USER ACCOUNT BLOCK (UAB) 
TASK ACCOUNT BLOCK (TAB) 
SYSLOG STARTUP TRANSACTION 
INVALID LOGIN TRANSACTION 
SYSTEM TIME CHANGE TRANSACTION 
ALLOCATE DEVICE TRANSACTION 
DEALLOCATE DEVICE TRANSACTION 
MOUNT DEVICE TRANSACTION 
DISMOUNT DEVICE TRANSACTION 
PRINT DESPOOLER TRANSACTION 
DISK ACCOUNTING BY DIRECTORY 

(UNSUPPORTED) 
DISK ACCOUNTING BY VOLUME 

(UNSUPPORTED) 
LOGIN TRANSACTION 
CRASH RECOVERY TRANSACTION 
DEVICE STATISTICS (UCB EXTENSION) 
RESET TRANSACTION PARAMETERS 
CARD READER SPOOLING TRANSACTION 



+ 

STATUS MASK BIT DEFINITIONS (B.STM) 



RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



ACNDF$ (Cont.) 



BS 


,ACT = 


B' 


200 


BS 


.CRH= ■ 


B 1 


100 


BS 


.LGO=' 


B' 


40 


BS 


.CO='B , 4 





BS 


. TML= ' 


B' 


20 


BS 


.SIL=' 


B' 


20 


BS 


. ZER= ' 


B' 


10 


BS 


.SCN=' 


B' 


4 



;CONTROL BLOCK ACTIVE 

; RECORD FROM " TMP" FILE AFTER SYSTEM CRASH 

; LOGGED OFF WITH OUTSTANDING ACTIVITY (UAB) 

;TASK'S TI: IS CO: (TAB ONLY) 

; TAB EXISTS ONLY FOR TIME LIMIT (TAB ONLY) 

;SILENT LOGIN/LOGOUT (UAB ONLY) 

; LAST CPU INTERVAL WAS OF LENGTH ZERO 

TRANSACTION READY FOR WRITE TO SCAN FILE 



+ 

ACCOUNTING FEATURE MASK ($ACNFE) 



BF 


,DST = 


'B 


40000 


STATISTICAL SCAN RATE 


BF 


• WRT = 


'B 


2000 


;FORCE SYSLOG TO WRITE ITS BUFFER 


BF 


.SCN = 


'B 


1000 


SCAN REQUESTED 


BF 


.SLR = 


'B 


400 


SYSLOG IS RUNNING (NOT STOPPED) 


BF 


. ERR = 


'B 


200 


ACCOUNTING STOPPED DUE TO FATAL ERROR 


BF 


. STR = 


•B 


100 


;ACCOUNTING IS STARTING UP / SHUTTING DOWN 


BF 


. LSS = 


'B 


40 


ACCUMULATE SYSTEM STATISTICS 










• (POINT UAB TO SAB) 


BF 


. TRN = 


'B 


10 


OUTPUT TO TRANSACTION FILE 


BF 


.XTK = 


'B 


4 


CHECKPOINT REQUEST IS DUE TO EXTK$ 


BF 


.TSK = 


•B 


2 , 


TASK ACCOUNTING TURNED ON 


BF 


.XAC = 


'B 


1 , 


EXTENDED ACCOUNTING ASSEMBLED IN 



+ 

SHUTDOWN CODES (B.SHDN) 



1 MAINTENANCE 

2 REBOOT 

3 SCHEDULED_SHUTDOWN 

4 ACCOUNTING SHUTDOWN BY TASK "SHUTUP" 

5 OTHER 



************************************************************************ 
i 

B.MAXL='B' 128. ;MAXIMUM TRANSACTION LENGTH 

B.MINL='B'$$$HLN ;MINIMUM TRANSACTION LENGTH 

.*************************************************** 



.PSECT 
.MACRO 
. ENDM 
. ENDM 



ACNDF$ X,Y 



.MACRO 
.ASECT 



ACTDF$,L,B 



.=0 

A.GRP: 'L' 
A.MBR: 'L' 
A . PSWD : ' L 1 
A.LNM: 'L' 
A.FNM: 'L ' 
A.LDAT: 'L' 



. BLKB 
. BLKB 
.BLKB 
.BLKB 
.BLKB 
.BLKB 



3 
3 
6 

14. 
12. 

6 



GROUP CODE (ASCII) 
MEMBER CODE 
PASSWORD 
LAST NAME 
FIRST NAME 
DATE OF LAST LOGON 
FORMAT = (DD/MM/YY HH:MM:SS) 
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ACNDF$ (Cont.) 



A . NLOG :: 


' L 1 


. BLKB 


2 


; TOTAL NUMBER OF LOGONS 


A.SYDV: 


'L' 


.BLKB 


4 


? DEFAULT SYSTEM DEVICE 


A.ACN: 1 


L' 


. BLKW 


1 


^ACCOUNT NUMBER (BINARY) 


A.CLI : 1 


L' 


.BLKW 


2 


■ RAD 50 USER CLI 






.BLKW 


2 


; UNUSED 


A.LPRVx 


'L' 


.BLEW 


1 


;LOGIN PRIVILEGE WORD 


A.SID: ' 


L ' 


.BLKW 


1 


; SESSION IDENTIFIER 


A.DDS: 1 


L ' 


.BLKB 


11. , 


'DEFAULT DIRECTORY STRING 






.BLKB 


1 


lUNUSED BYTE 


A.FPRO:: 


'L' 


.BLKW 


1 , 


DEFAULT FILE PROTECTION 


A . RLVL :: 


' L ' 


.BLKW 


1 


;ACCOUNT RECORD REV. LEVEL 


AR.LVL== 


'B'401 








A . SALT : 


•L' 


.BLKW 


1 , 


16-BIT ENCRYPTION SALT VALUE 


A.ENCT:: 


•L' 


.BLKB 


1 , 


'ENCRYPTION TYPE 



A.HPW: 'L 



.BLKB 1 
,BLKW 4 

, IF DF A$$LOG 



A.TTY: 'L' 
A.PRID: 'L' 
A.SECD 
A.PRIT 
A. SECT 
A.RLEN 



L' 
L' 
L' 
= 'B 



i BLKB 
BLKB 
BLKB 

, BLKW 
BLKW 



A.LEN 



= 'B 



. ENDC ; DF A$$LOG 
128. 



= PLAIN TEXT OR ENCRYPT 

1 = PURDY-V ALGORITHM 

UNUSED 

HASHED PASSWORD 



/TERMINAL TTNNN FOR AUTO LOGIN 
; PRIMARY DAYS MASK 
; SECONDARY DAYS MASK 
; PRIMARY DAYS TIME 
; SECONDARY DAYS TIME 



; LENGTH OF CONTROL BLOCK 



BIT DEFINITIONS ON A.LPRV - LOGIN PRIVILEGE BITS 



AL.SLV= 
AL.DDS= 
AL.SIL= 



AL.AUT= 
AL.BND' 
AL . RMT : 
AL . NET : 
AL.DIS= 
AL.PRI= 
AL.SEC: 



'B' 
'B' 
•B' 



'B' 
'B' 
'B' 
•B' 
B ' 
■B' 
'B ' 



1 
2 
4 

.IF DF A$$LOG 

10 

20 

40 

100 

200 

400 

1000 

.ENDC ; DF A$$LOG 



;SLAVE TERMINAL ON LOGIN 

; INDICATOR FOR PROLOGUE 2 FORMAT 

; SI LENT LOGIN/LOGOUT 



('*) 
CY) 



;AUTO LOGIN ENABLED 
;BINDING ENABLED 
; REMOTE DIALUP l=NO 
; NETWORK LOGIN l=NO 
;DISABLE THIS ACCOUNT FROM LOGIN 
; PRIMARY DAYS LIMIT SET 
/SECONDARY DAYS LIMIT SET 



.PSECT 
. ENDM 
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CLKDF$ 



. MACRO CLKDF$,L,B 

; + 

; CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS 

; CLOCK QUEUE CONTROL BLOCK 
/ 

; THERE ARE FIVE TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL BLOCK 

; HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS IN THE REMAINING 

; THREE. THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED: 



C.MRKT='B'0 
C . SCHD= 'B 1 2 
C.SSHT='B I 4 
C.SYST= , B , 6 

C.SYTK='B'8. 

C.CSTP='B'10, 



MARK TIME REQUEST 

TASK REQUEST WITH PERIODIC RESCHEDULING 
SINGLE SHOT TASK REQUEST 

SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 
(IDENT) 

SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 
(TASK) 

CLEAR STOP BIT (COND I T IONAL I Z ED ON 
SHUFFLING) 



CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS 



.ASECT 

.=0 

C.LNK: 'L' . BLKW 1 

C.RQT: 'L' . BLKB 1 

C.EFN: 'L' .BLKB 1 

C.TCB: 'L 1 .BLKW 1 

C.TIM: 'L' .BLKW 2 



CLOCK QUEUE THREAD WORD 
REQUEST TYPE 

EVENT FLAG NUMBER (MARK TIME ONLY) 
TCB ADDRESS OR SYSTEM SUBROUTINE 

IDENTIFICATION 
ABSOLUTE TIME WHEN REQUEST COMES DUE 



CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS 



.=C.TIM+4 
CAST: 'L' .BLKW 1 
C.SRC: 'L • .BLKW 1 
C.DST: 'L' .BLKW 1 
•BLKW 1 



; START OF DEPENDENT AREA 
;AST ADDRESS 

;FLAG MASK WORD FOR 'BIS' SOURCE 
; ADDRESS OF 'BIS' DESTINATION 
;UNUSED 



CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET DEFINITIONS 



.=C.TIM+4 

C . RS I : 1 L 1 .BLKW 2 
C.UIC: 'L' .BLKW 1 
C.UAB: *L' .BLKW 1 



; START OF DEPENDENT AREA 

; RESCHEDULE INTERVAL IN CLOCK TICKS 

SCHEDULING UIC 

; POINTER TO ASSOCIATED UAB 



CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS 
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CLKDF$ (Cont.) 



=C.TIM+4 

• BLKW 
. BLKW 
.BLKW 



; START OF DEPENDENT AREA 
;TWO UNUSED WORDS 
,-SCHEDULING UIC 
;C.UAB 



CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET 
DEFINITIONS 

THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST : * L ' 

TYPE 6=SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE AS AN 
IDENTIFIER. 

TYPE 8=SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS AN 
IDENTIFIER. 



. =C.TIM+4 
C.SUB: 'L' .BLKW 1 
C.AR5: 1 L ' .BLKW 1 
C.URM: 'L' .BLKW 1 

•BLKW 1 
C . LGTH= ' B ' . 



START OF DEPENDENT AREA 
SUBROUTINE ADDRESS 

RELOCATION BASE (FOR LOADABLE DRIVERS) 
URM TO EXECUTE ROUTINE ON 
(MP SYSTEMS, C.SYST ONLY) 
UNUSED 

LENGTH OF CLOCK QUEUE CONTROL BLOCK 



NAMED DIRECTORY SUPPORT 

OFFSET C.EFN WILL BE REUSED IN SCHEDULING REQUESTS TO INDICATE IF C.UIC 
HAS A VALID UIC (C.NAM=0) OR IF C.UIC POINTS TO A CONTEXT BLOCK WITH A 
DDS. IN SCHEDULE REQUESTS, C.EFN WILL BE REFERRED TO AS C.NAM. 



C.NAM='B' C.EFN 



; FLAG WORD FOR USE WITH NAME DIRECTORIES 



DEPENDING ON THE VALUE IN C.NAM, C.UIC WILL CONTAIN A UIC OR A POINTER 
TO A CONTEXT BLOCK. C.UIC WILL BE REFERED TO AS C.CTX WHEN IT CONTAINS 
A POINTER TO A CONTEXT BLOCK. 



C.CTX='B 'C.UIC 



; POINTER TO CONTEXT BLOCK 



.PSECT 



.MACRO CLKDF$ X,Y 
. ENDM 
. ENDM 
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CTBDF$ 



.MACRO CTBDF$ 



CONTROLLER TABLE (CTB) 

THE CONTROLLER TABLE IS A CONTROL BLOCK THAT CONTAINS A 
VECTOR OF KRB ADDRESSES. THIS VECTOR MAY BE ADDRESSED 
BY THE CONTROLLER INDEX TAKEN FROM THE INTERRUPT PS BY 
$INTSV/$INTSE. 

.ASECT 





.=177756 








177756 


L.CLK: 


. BLKW 


8. 


; START OF CLOCK BLOCK (IF ANY) 


177776 


L . ICB : 


. BLKW 


1 


;ICB CHAIN FOR THIS CTB 


000000 


L.LNK: 


. BLKW 


1 


;CTB LINK WORD 


000002 


L . NAM : 


.BLKW 


1 


; GENERIC CONTROLLER NAME (ASCII) 


000004 


L . DCB : 


.BLKW 


1 


;DCB ADDRESS OF THIS DEVICE 


000006 


L.NUM: 


. BLKB 


1 


; NUMBER OF KRB ADDRESSES IN TABLE 


000007 


L.STS: 


. BLKB 


1 


;CTB STATUS BYTE 


000010 


L.KRB: 


. BLKW 


1 


; START OF KRB ADDRESSES 



NOTE: THE SYMBOL $XYCTB:: IS DEFINED FOR EACH CTB, 
WHERE THE CHARACTERS XY ARE THE SAME AS THOSE STORED IN 
L.NAM. THESYMBOL IS NOT THE START OF THE CTB, BUT THE 
START OFTHE KRB TABLE AT THE END OF THE CTB (L.KRB). 

.PSECT 



CONTROLLER TABLE STATUS BYTE BIT DEFINITIONS 

LS.CLK=1 ;CLOCK BLOCK AT TOP OF CTB (1=YES) 

LS.MDC=2 ;MULTIDRIVER CTB (1=YES) 

LS.CBL=4 ;CLOCK BLK LINKED INTO CLK Q (1=YES > 

LS.CIN=10 ;CONT. USE COMMON INT TABLE (1=YES) 

LS.NET=20 ;THIS IS DECNET DEVICE. 

;ICB'S IN K.PRM 

; (1=YES) 

COMMON INTERRUPT TABLE DISPATCH ENTRY POINTS 

CI.CSR=-6 ;CSR TEST ENTRY POINT 

CI.KRB=-4 ; KRB STATUS CHANGE ENTRY POINT 

CI.PWF=-2 ;POWERFAIL ENTRY POINT 

CI.INT=0 ;COMMON INTERRUPT ADDRESS 

CI.DCB=2 ; START OF DCB TABLE (0 ENDS TABLE) 
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DCBDF$ 



. MACRO DCBDF$,L,B 



DEVICE CONTROL BLOCK 

THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC INFORMATION ABOUT A DEVICE 
TYPE AND THE LOWEST AND HIGHEST UNIT NUMBERS. THERE IS AT LEAST ONE DCB 
FOR EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE, IF THERE ARE TELETYPES IN A 
SYSTEM, THEN THERE IS AT LEAST ONE DCB WITH THE DEVICE NAME 1 TT ' . IF PART 
OF THE TELETYPES WERE INTERFACED VIA DLll-A'S AND THE REST VIA A DHll, THEN 
THERE WOULD BE TWO DCB'S. ONE FOR ALL DLll-A INTERFACED TELETYPES, AND ONE 
FOR ALL DHll INTERFACED TELETYPES. 



.ASECT 

.=0 

D.LNK: 'L' .BLKW 1 
D.UCB: 'L' .BLKW 1 
D.NAM: 'L' .BLKW 1 
D.UNIT: 'L' . BLKB 1 

. BLKB 1 
D.UCBL: 'L' .BLKW 1 



D.DSP: »L ' 
D.MSK: ' L 1 



D.PCB: 'L 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 



LINK TO NEXT DCB 

POINTER TO FIRST UNIT CONTROL BLOCK 
GENERIC DEVICE NAME 

LOWEST UNIT NUMBER COVERED BY THIS DCB 
HIGHEST UNIT NUMBER COVERED BY THIS DCB 
LENGTH OF EACH UNIT CONTROL BLOCK IN BYTES 
POINTER TO DRIVER DISPATCH TABLE 
LEGAL FUNCTION MASK CODES 0-15. 
CONTROL FUNCTION MASK CODES 0-15. 
NOP' ED FUNCTION MASK CODES 0-15. 
ACP FUNCTION MASK CODES 0-15. 
LEGAL FUNCTION MASK CODES 16.-31. 
CONTROL FUNCTION MASK CODES 16.-31. 
NOP'ED FUNCTION MASK CODES 16.-31. 
ACP FUNCTION MASK CODES 16.-31. 
LOADABLE DRIVER PCB ADDRESS 



-PSECT 



DRIVER DISPATCH TABLE OFFSET DEFINITIONS 



D.VDEB='B'-2 
D.VCHK='B'-4 



D.VNXC='B , -4 

D.VTOU= 'B'-IO 
D.VTIN= 'B ' -6 



D.VINI = 
D.VCAN= 
D.VOUT= 
D.VPWF= 
D . VKRB : 
D.VUCB= 



•B'O 

•B'2 

'B'4 

'B'6 

'B'10 

•B'12 



DEALLOCATE BUFFER (S) 

ADDRESS OF ROUTINE CALLED TO VALIDATE 

AND CONVERT THE LBN. USED BY DRIVERS 

THAT SUPPORT SEEK OPTIMIZATION. 

ADDRESS OF ROUTINE IN TTDRV CALLED TO 

HAVE IT SEND THE NEXT COMMAND IN THE 

TYPEAHEAD BUFFER TO MCR... 

ADDRESS OF ROUTINE IN TTDRV CALLED 

FOR OUTPUT COMPLETION 

ADDRESS OF ROUTINE IN TTDRV CALLED 

FOR INPUT FROM THE CT FIRMWARE TASK 

DEVICE INITIATOR 

CANCEL CURRENT I/O FUNCTION 

DEVICE TIMEOUT 

POWERFAIL RECOVERY 

CONTROLLER STATUS CHANGE ENTRY 

UNIT STATUS CHANGE ENTRY 
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DCBDFS (Cont.) 



.IF NB SYSDEF 

D.VINT='B'14 ;BEGINNING OF INTERRUPT DATA 

. ENDC 



.MACRO DCBDF$,X,Y,Z 
. ENDM 
. ENDM 
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EPKDFS 



. MACRO EPKDF$,L,B 



Error Message Block Definitions 

. ASECT 
Header Subpacket 



Subpacket Length in 


Bytes 


Subpacket Flags 




Format Identification | Operating System Code 


Operating System Identification 


Flags 


| Context Code 


Entry Sequence 


Error Sequence 




Entry Type Subcode 


| Entry Type Code 
+ 


Time Stamp 




Reserved 


| Processor Type 


Processor Identification (URM) 



.=0 










E$HLGH 


: 'L' 


.BLKW 


1 


; Subpacket length in bytes 


E$HSBF 


: ' L 1 


. BLKW 


1 


; Subpacket Flags 


E$HSYS 


: ' L 1 


.BLKB 


1 


; Operating System Code 


E$HIDN 


: * L 1 


. BLKB 


1 


; Format Identification 


E$HSID 


: 'L' 


.BLKB 


4 


; Operating System Identification 


E$HCTX 


: ' L 1 


.BLKB 


1 


Context Code 


E$HFLG 


: 'L' 


.BLKB 


1 


; Flags 


E$HENS 


' L ' 


. BLKW 


1 


; Entry Sequence Number 


E$HERS 


• 'L' 


.BLKW 


1 , 


• Error Sequence Number 


E$HENC 


: 'L' 






; Entry Code 


E$HTYC 


•L' 


.BLKB 


1 


Entry Type Code 


E$HTYS. 


'L' 


.BLKB 


1 , 


Entry Type Subcode 


E$HTIM: 


' L 1 


.BLKB 


6 J 


Time Stamp 


E$HPTY: 


1 L * 


.BLKB 


1 


Processor Type 






.BLKB 


1 


' Reserved 


E$HURM" 


' L ' 


.BLKW 


1 , 


• Processor Identification (URM) 






.EVEN 







E$HLEN: 'L' 



; Length 
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EPKDFS (Cont.) 



Subpacket Flags 


for 


E$HSBF 






SM.ERR 




'B' 


1 


; Error Packet 




SM.HDR 




'B' 


1 


ncdUcJ. OUJJ£JaL-Js.fcrL. 




SM.TSK 


_ 


'B' 


2 


; Task Subpacket 




SM.DID 




•B' 


4 


; Device Identification Subpacket 




SM.DOP 


_ 


'B' 


10 , 


Device Operation Subpacket 




SM.DAC 




'B' 


20 


; Device Activity Subpacket 




SM . DAT 


_ 


'B' 


40 , 


Data Subpacket 




SM.MBC 




'B' 


20000 


; 22-bit massbus controller present 




SM.CMD 


_ 


B' 


40000 , 


Error Log Command Packet 




SM.ZER 




'B' 


100000 


; Zero I/O Counts 


Codes 


for field 


E$HIDN 






EH$FOR 


_ 


'B' 


2 ; Current packet format 


Flags 


for the 


error 


log flags byte ($ERFLA) in the Executive 




ES. INI 


_ 


B' 


1 


, Error log initialized 




ES.DAT 




•B' 


2 


; Error log receiving data packets 




ES.LIM 


_ 


B' 


4 , 


Error limiting enabled 




ES.LOG 




•B' 


10 


; Error logging enabled 



Type and Subtype Codes for fields E$HTYC and E$HTYS 

Symbols with names E$Cxxx are type codes for field E$HTYC, 
Symbols with names E$Sxxx are subtype codes for field E$HTYS. 



E$CCMD 
E$SSTA 
E$SSWI 
E$SAPP 
E$SBAC 
E$SSHO 
E$SCHL 
E$CERR 
E$SDVH 
E$SDVS 
E$STMO 
E$SUNS 
E$STMS 

E$CDVI 
E$SDVI 

E$CDCI 
E$SMOU 
E$SDMO 
E$SRES 
E$SRCT 

E$CMEM 
E$SMEM 



'B' 
•B' 
'B' 
'B 1 
'B' 
•B' 
'B' 
'B' 
'B' 
'B' 
•B' 
•B' 
'B' 

'B' 
'B' 

•B' 
•B' 
'B' 
'B' 
'B' 

*B' 
'B' 



1 ; Error Log Control 

1 ; Error Log Status Change 

2 ; Switch Logging Files 

3 ; Append File 

4 ; Declare Backup File 

5 ; Show 

6 ; Change Limits 
2 ; Device Errors 

1 ; Device Hard Error 

2 ; Device Soft Error 

3 ; Device Interrupt Timeout (HARD) 

4 ; Device Unsolicited Interrupt 

5 ; Device Interrupt Timeout (SOFT) 

3 ; Device Information 

1 ; Device Information Message 

4 ; Device Control Information 

1 ; Device Mount 

2 ; Device Dismount 

3 ; Device Count Reset 

4 ; Block Replacement 

5 ; Memory Detected Errors 
1 ; Memory Error 
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E$CSYS ='B' 6 ; System Control Information 

E$SPWR ='B' 1 ; Power Recovery 

E$CCTL ='B' 7 ; Control Information 

E$STIM ='B' 1 ; Time Change 

E$SCRS ='B' 2 ; System Crash 

E$SLOA ='B' 3 ; Device Driver Load 

E$SUNL ='B' 4 ; Device Driver Unload 

E$SHRC ='B' 5 ; Reconfiguration Status Change 

E$SMES ='B' 6 ; Message 

E$CCPU ='B' 10 ; CPU Detected Errors 

E$SINT ='B* 1 ; Unexpected Interrupt 

E$SINT ='B' 2 ; Unexpected Interrupt 

} 

; Subtype code 2 is reserved. Use 3 for the next following Subtype code 

E$CSDE ='B' 11 ; Software Detected Events 

E$SABO ='B' 1 ; Task Abort 

; Codes for Context Code entry E$HCTX 

EH$NOR ='B' 1 ; Normal Entry 

EH$STA ='B' 2 ; Start Entry 

EH$CRS ='B' 3 ; Crash Entry 

; Codes for Flags entry E$HFLG 

EH$VIR ='B' 1 ; Addresses are virtual 

EH$EXT ='B' 2 ; Addresses are extended 

EH$COU ='B' 4 ; Error counts supplied 

EH$QBS ='B' 10 ; Q-BUS CPU 

EH$LMR ='B' 20 ; Limit reached 

; Task Subpacket 

J + + 

; | Task Subpacket Length | 

; + + 

; | Task Name in RAD 50 

; + + 

; | Task UIC | 

; + + 

; | Task TI: Device Name | 
; + + + 

; | Flags | Task TI : Unit Number | 
; + + + 

.=0 
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E$TLGH : 1 L 1 . BLKW 1 

E$TTSK: ' L ' .BLKW 2 

E$TUIC:'L' . BLKW 1 

E$TTID: 'L 1 .BLKB 2 

E$TTIU: 'L' .BLKB 1 

E$TFLG : ' L 1 .BLKB 1 

.EVEN 
E$TLEN : 'L' 



Flags for entry E$TFLG 

ET$PRV ='B' 
ET$PRI = , B I 



Task Subpacket Length 
Task Name in RAD 50 
Task UIC 

Task TI: Device Name 
Task TI: Unit 
Flags 



1 ; Task is Privileged 

2 ; Terminal is Privileged 



Device Identification Subpacket 

+ 
I 

+ 

l 

+ 

l 

+ 
I 

+ 

l 

+ 
I 

+ 

Volume Name of Mounted Volume 



Device Identification 


Subpacket Length 


Device Mnemonic Name 


. + 


Controller Number 


| Device Unit Number 
. + 


Physical Subunit # 


| Physical Unit # 


Physical Device Mnemonic (RSX-11M-PLUS only) 


Reserved 


| Flags 
_+ 



Device Type 



+ + 

Pack Identification 

Device Type Class 



+ + 

I/O Operation Count Longword 

+ + 

| Hard Error Count | Soft Error Count 

+ + 

Blocks Transferred Count (RSX-11M-PLUS only) 



+ + 

Cylinders Crossed Count (RSX-11M-PLUS only) 
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.=0 










E$ ILGH : ' 


L ' 


.BLKW 


1 ; 


Device Identification Subpacket 


E$ILDV: ' 


L 1 


.BLKW 


1 ; 


Device Mnemonic Name 


E$ILUN: ' 


L 1 


.BLKB 


1 ; 


Device Unit Number 


E$IPCO: ' 


L 1 


.BLKB 


1 ; 


Controller Number 


T? C T DMM • 1 
£js> 1 f U INI • 


r i 


. D Lil\D 


1 


Physical Unit Number 


pct pen • ' 


r i 

Li 


nr ifR 

• DL i\£j 


1 ; 


Physical Subunit Number 






TV DP 


R$$MPL 




E$ IPDV : ' 


L • 


.BLKW 


1 ; Physical Device Mnemonic 






. ENDC ; 


R$$MPL 




E$ IFLG : 


L ' 


.BLKB 


1 


; Flags 






.BLKB 


1 


■ Reserved 


E$IVOL: 


L' 


.BLKB 


12. 


; Volume Name 


E$IPAK: 


L 1 


.BLKB 


4 


; Pack Identification 


£j9 1 UEj V • 


r 1 

Li 






; Device Type 


E$IDCL: 


L 1 


.BLKW 


1 


; Device Type Class 


E$ IDTY : 


L' 


.BLKW 


2 


; Device Type 


E$IOPR: 


L 1 


.BLKW 


2 


; I/O Operation Count Longword 


E$IERS: 


L 1 


.BLKB 


1 


; Soft Error Count 


E$IERH: 


'L' 


.BLKB 


1 


; Hard Error Count 






.IF DF 


R$$MPL 




E$ IBLK : 


'L' 


.BLKW 


2 


; Blocks transferred count 


E$ICYL: 


1 L 1 


.BLKW 


2 


; Cylinders crossed count 






.ENDC 1 ; 


R$$MPL 






.EVEN 








E$ ILEN : 


1 L ' 






; Subpacket Length 


; Flags 


for field E$IFLG 






EI$SUB 


= 'B' 


1 


; Subcontroller device 






. IF DF 


R$$MPL 






EI$NUX 


= 'B' 


2 


; No UCB extension, data invalid 



. ENDC ; R$$MPL 



Device Operation Subpacket 



+ + 

| Device Operation Subpacket Length | 
+ + 

Task Name in RAD 50 

+ + 

| Task UIC | 
+ + 

| Task TI: Logical Device Mnemonic | 
+ + + 
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Reser ved 


+ 

| Task TI : Device Unit 


I/O Function Code 


+ 


Reserved 


| Operation Flags 
+ 


Transfer Operation 


Address 


Transfer Operation 


Byte Count 


Maximum Retries 


| Retries Left 



'.=0 










E$OLGN: 


'L* 


.BLKW 


1 




E$0TSK: 


'L' 


. BLKW 


2 




E$OUIC: 


'L' 


.BLKW 


1 




E$OTID: 


'L' 


. BLKB 


2 




E$OTIU: 


'L' 


.BLKB 


1 








.BLKB 


1 




E$OFNC: 


'L' 


.BLKW 


1 




E$OFLG: 


•L' 


.BLKB 


1 








.BLKB 


1 




E$OADD: 


•L' 


.BLKW 


2 




E$OSIZ: 


•L' 


.BLKW 


1 




E$ORTY: 


1 L ' 


.BLKB 


1 








.BLKB 


1 






.EVEN 








E$OLEN: 


'L' 








; Flags 


for field E$OFLG 






EO$TRA 


= 'B' 




1 




EO$DMA 


= 'B' 




2 




EO$EXT 


= 'B ' 




4 




EO$PIP 


= 'B ' 




10 




EO$IIO 


= »B' 




20 



Subpacket Length 
Task Name in RAD 50 
Task UIC 

Task TI: Logical Device Mnemonic 
Task TI: Logical Device Unit 
Reserved 

I/O Function Code 
Operation Flags 
Reserved 

Transfer Operation Address 
Transfer Operation Byte Count 
Retries Left 
Maximum Retries 



; Device Operation Subpacket Length 



Transfer Operation 
DMA Device 

Extended Addressing Device 
Device is positioning 
Internal I/O operation 



I/O Activity Subpacket 



I/O Activity Subpacket Length 



.=0 

E$ALGH: 'L ' 



.BLKW 



; Subpacket Length 
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I/O Activity Subpacket Entry 



| Logical Device Name Mnemonic | 
+ + + 

| Controller Number | Logical Device Unit | 
+ + + 

| Physical Subunit # | Physical Unit Number | 
+ + + 

| Physical Device Mnemonic (RSX-llM-PLUS only) | 

+ + + 

| Task TI: logical unit | Device flags | 
+ + + 

| Requesting Task Name in RAD 50 | 

+ + 

| Requesting Task UIC | 

+ + 

| Task TI: Logical Device Name 



| I/O Function Code 

+ + 

| Reserved | Flags 
+ + 

| Transfer Operation Address 

+ 

| Transfer Operation Byte Count 
+ 



.=0 








E$ALDV: 


'L' 


.BLKW 


1 


E$ALUN: 


•L' 


. BLKB 


1 


E$APCO: 


' L 1 


.BLKB 


1 


E$APUN: 


'L' 


.BLKB 


1 


E$APSU: 


•L' 


.BLKB 


1 






. IF DF 


R$$MPL 


E$APDV: 


'L' 


.BLKW 


1 






. ENDC 




E$ADFG: 


'L' 


.BLKB 


1 


E$ATIU: 


'L' 


.BLKB 


1 


E$ATSK: 


•L' 


.BLKW 


2 


E$AUIC: 


•L' 


.BLKW 


1 


E$ATID : 


'L' 


.BLKW 


1 


E$AFNC: 


■L' 


.BLKW 


1 


E$AFLG: 


'L' 


.BLKB 


1 






.BLKB 


1 


E$AADD: 


'L' 


.BLKW 


2 


E$ASIZ: 


•L' 


.BLKW 


1 




.EVEN 







Logical Device Name Mnemonic 
Logical Device Unit 
Controller Number 
Physical Unit Number 
Physical Subunit Number 



; Physical Device Mnemonic 



Device flags 

Task TI : Logical Unit 

Requesting Task Name in RAD 50 

Requesting Task UIC 

Task TI: Logical Device Name 

I/O Function Code 

Flags 

Reserved 

Transfer Operation Address 
Transfer Operation Byte Count 
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E$ALEN: *L' 

Flags for field E$ADFG 

EA$SUB ='B' 1 

.IF DF R$$MPL 
EA$NUX ='B' 2 
. ENDC ; R$$MPL 
Flags for field E$AFLG 



EA$TRA ='B' 

EA$DMA ='B' 

EA$EXT ='B' 

EA$PIP ='B' 

EA$IIO =*B' 
.PSECT 



1 
2 
4 
10 
20 



Subpacket Entry Length 



Subcontroller device 



No UCB extension, data invalid 



Transfer Operation 
DMA Device 

Device has Extended Addressing 
Device is positioning 
Internal I/O operation 



FLAG DEFINITIONS FOR ERROR LOG FEATURE MASK 

EL.ICM ='B' 1 ;SET - Inhibit Operator Console Messages 

EL.SEF ='B' 2 ;SET - Special File Formats Enabled 

EL.MOU ='B' 4 ;SET .- Process MOU/DMO In Special Files 



.MACRO EPKDF$ X,Y 
.ENDM 

. ENDM 
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.MACRO EVNDF$ L,B,LST 



EVNDF$ — Event Packet Definitions 

This module contains a macro which defines the offsets and field 
values for TSA Event Packets (TEP's). These packets are used to 
pass data and status information between system components that 
provide Digital's Terminal Software Architecture support on RSX. 



Explicit Inputs: 

L ":" for global offset definitions 

B "=" for global bit/value definitions 

LST "LIST" for macro expansion listing 

Implicit Inputs: 

NONE 

Outputs : 

Symbols defined as described above. 
Listing as described above. 



General packet header format 

.ASECT 
.=0 



; Define offsets absolutely 



E.VLNK: 'L ' 
E.VSIZ: 'L' 
E.VTYP: 'L' 
E . VUCB: 'L' 



.BLKW 
, BLKB 
, BLKB 
, BLKW 



Link word 
Packet size 
Packet type 
Terminal UCB address 



E.VTYP Values 



ET 


.LOW= 


B 


•o 


ET 


.QIO = 


B 


•o 


ET ,BND= 1 


B 


'2 


ET 


.UNB = 


B 


' 4 


ET 


.BCP=' 


B 


'6 


ET 


. REJ = 


B 


'10 


ET 


.DIS=' 


B 


•12 


ET 


.DCP=" 


B 


•14 


ET 


. ICS=' 


B 


'16 


ET 


.OOB = 


B 


'20 


ET 


,ONO=' 


B 


'22 


ET 


.PHO=' 


B 


'24 


ET 


.HI='B' 


24 



Lowest valid type code 

QIO (distinguishes QIO packet from TEP) 
Bind Request 
Unbind Request 
Bind Complete 
Bind Reject 

Disconnect Notification 
Disconnect Complete 
Input Count State Change 
Out-of-Band (OOB) 
Abnormal Termination Request 
Physical Terminal Disconnected 

; Highest valid type code 
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The following definitions are for packet types that require 
passing additional information in the packets. All other 
packet types use the general packet format described above. 



Bind Request packet (Terminal Management Mode — > Network) 
.=E.VUCB+2 



E.VBCT: ' L 1 
E.VBND: ' L ' 
E.VBLN: ' L * 



.BLKW 
. BLKB 



; Count of nodes (One for now) 
; Node name 

; Length of bind request 



Input Count State Change, Out-Of-Band packets (TTDRV — > Network) 
And Modem Hang-up packets (TSA... — > Network) 



.=E.VUCB+2 



E.VAPR: 1 L 1 
E . VADR : ' L 1 
E.VFLG: 'L' 



.BLKW 1 
. BLKW 1 
.BLKW 1 



Input Count State Change 
.=E.VFLG+2 
E.VSLN: 'L' 



Doubleword address of packet 

. . .queueing routine 

Flag 



; Length of Input state message 



00B 



.=E. VFLG+2 



E . VOBM : ' L ' 
E.VHDR: 'L 1 
E.VTAB: 'L' 
E.VOLN: 'L' 



.BLKW 
.BLKW 
.BLKB 



6 
2 

10 



Out-of-Band bitmasks 
Type-ahead buffer header 
Type-ahead buffer 
Length of OOB packet 



Terminal Management Switch Characters 
.=E. VFLG+2 



E . VSWC : 1 L • 
E.VTLN: 'L' 



.BLKW 



; Terminal management switch characters 
; Length of Switch Character packet 



Bit values in flag word (E.VFLG). For convenience some bits have 
corresponding bits in the AST Control Block flag word (A.PRM+5). 
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EF.NCO=*B'l 

EF.NOI='B'2 

EF.AST='B'10 

EF.LCK='B , 40 

EF.QUE= 'B 1 100 

EF.MDE='B'200 



All non-control characters are out-of band 

All non-control OOB are include-OOB 

Reserved bit synonymous with TF.AST 

Reserved bit synonymous with AF.LCK 

TEP is queued 

TEP is marked for delete 



Unbind Request packet (TMM --> Network) 
,=E.VUCB+2 

E.VULN:'L' ; Length of Unbind message 

Connect Reject notification packet (Network — > TMM) 
.=E.VUCB+2 

E.VRR:'L' .BLKW 1 ; Reason for Rejection 

E . VRLN : 1 L 1 ; Length of Reject message 

Disconnect Notification packet (Network — > TMM) 
.=E.VUCB+2 

E.VRDr'L' .BLKW 1 ; Reason for Disconnect 

E.VDLNt'L 1 ; Length of Disconnect message 

Disconnect Complete packet (TMM — > Network) 
.=E.VUCB+2 

E.VDCL:*L' ; Length of Disconnect Complete message 



.PSECT 



IF NB LST 

. NLIST 

IFF 

.MACRO EVNDF$ 
. ENDM 

ENDC 

.ENDM EVNDF$ 



; Turn listing back off 

; If not listing, redefine 
; macro to nothing 
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.MACRO F11DF$,L,B 



VOLUME CONTROL BLOCK 



.=0 



.ASECT 



V.TRCT 
V.TYPE: 



V. VCHA: 



V.LABL: 
V. PKSR: 
V. SLEN: 
V. IFWI : 
V.FCB: 1 
V. IBLB: 
V. IBSZ : 

V.FMAX: 
V.WISZ: 



•L ' .BLKW 
■L 1 . BLKB 
VT.FOR= 
VT.SL1= 
VT.SL2= 
VT.ANS= 
VT.UNL= 
'L' .BLKB 
VC.SLK= 
VC.HLK= 
VC.DEA= 
VC.PUB= 
VC.DUP= 
VC.SIL= 
'L ' .BLKB 
'L' .BLKW 
'L' 

•L 1 .BLKW 
L ' .BLKW 
'L 1 .BLKB 
'L 1 .BLKB 

.BLKW 
•L ' .BLKW 
'L' .BLKB 



V.SBCL: 'C .BLKB 
V.SBSZ: 'L' .BLKW 
V.SBLB: 'L * .BLKB 
V.FIEX: 'L' .BLKB 
.BLKW 



1 

1 
•B • 
•B» 
'B' 
•B' 
'B' 

1 
'B ' 
•B' 
'B 1 
'B ' 
'B' 
'B' 

14 

2 

1 
2 
1 
1 
1 
1 
1 

1 
1 
1 
1 
1 



WARNING 




1 
2 

10 
11 

1 
2 
4 

10 
20 
40 



TRANSACTION COUNT 

VOLUME TYPE DESCRIPTOR 

FOREIGN VOLUME STRUCTURE 

FILES-11 STRUCTURE LEVEL 1 

FILES-11 STRUCTURE LEVEL 2 

ANSI LABELED TAPE 

UNLABELED TAPE 

VOLUME CHARACTERISTICS 

CLEAR VOLUME VALID ON DISMOUNT 

UNLOAD THE VOLUME ON DISMOUNT 

DEALLOCATE THE VOLUME ON DISMOUNT 

SET (CLEAR) US. PUB ON DISMOUNT 

DUPLICATE VOLUME NAME; DON'T DELETE LOGICALS 
SILENT MODE; SUPPRESS DISMOUNT COMPLETE MESSAGE 
VOLUME LABEL (ASCII) 

PACK SERIAL NUMBER FOR ERROR LOGGING 

LENGTH OF SHORT VCB 

INDEX FILE WINDOW 

FILE CONTROL BLOCK LIST HEAD 

INDEX BIT MAP 1ST LBN HIGH BYTE 

INDEX BIT MAP SIZE IN BLOCKS 

INDEX BITMAP 1ST LBN LOW BITS 

MAX NO. OF FILES ON VOLUME 

DEFAULT SIZE OF WINDOW IN RTRV PTRS 

VALUE IS < 128. 

STORAGE BIT MAP CLUSTER FACTOR 
STORAGE BIT MAP SIZE IN BLOCKS 
STORAGE BIT MAP 1ST LBN HIGH BYTE 
DEFAULT FILE EXTEND SIZE 
STORAGE BIT MAP 1ST LBN LOW BITS 



THE FOLLOWING CELLS OF THE VCB ARE ORDER DEPENDENT. 
THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND 
MUST BE KEPT CONTIGUOUS. IF THE ORDER OF THE CELLS 
IS BROKEN, THE CODE MAY BREAK AS WELL. 



V.VOWN: ' L 1 .BLKW 
V.VPRO: 'L' .BLKW 
V.FPRO: 'L * .BLKW 
V.FRBK: 'L' .BLKB 
V.LRUC: 'L' .BLKB 
.BLKW 



VOLUME OWNER'S UIC 

VOLUME PROTECTION 

VOLUME DEFAULT FILE PROTECTION 

NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE 

COUNT OF AVAILABLE LRU SLOTS IN FCB LIST 

NUMBER OF FREE BLOCKS ON VOLUME LOW BITS 
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WARNING 



THE ABOVE CELLS OF THE VCB ARE ORDER DEPENDENT. 
THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND 
MUST BE KEPT CONTIGUOUS. IF THE ORDER OF THE CELLS 
IS BROKEN, THE CODE MAY BREAK AS WELL. 



V. STS : ' L 1 .BLKB 1 
VS.IFW='B' 
VS . BMW= 1 B 1 
V.FFNU: 'L ' .BLKB 1 
V. EXT : 1 L * .BLKW 1 
V.HBLB: 'L' .BLKW 2 
V.HBCS: 'L' .BLKW 2 
V.LGTH: 'L' 



VOLUME STATUS BYTE, CONTAINING THE FOLLOWING 

INDEX FILE IS WRITE ACCESSED 

STORAGE BITMAP FILE IS WRITE ACCESSED 

FIRST FREE INDEX FILE BITMAP BLOCK 

POINTER TO VCB EXTENSION 

LBN OF HOME BLOCK 

HOME BLOCK CHECKSUMS 

SIZE IN BYTES OF VCB 



MOUNT LIST ENTRY 

EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUBLIC DEVICE 

TO ALLOW EXPANSION, ONLY THE ONLY TYPE CODE DEFINED IS "1" FOR 
DEVICE ACCESS BLOCKS 



.ASECT 



.=0 



M.LNK: 'L 1 .BLKW 1 

M . TYPE : 'L 1 .BLKB 1 
MT .MLS= ' B 

M.ACC: 'L' .BLKB 1 

M.DEV: 'L' .BLKW 1 

M.TI : 'L' .BLKW 1 
M.LEN: 'L' 



LINK WORD 
TYPE OF ENTRY 

MOUNTED VOLUME USER ACCESS LIST 
NUMBER OF ACCESSES 
DEVICE UCB 
ACCESSOR TI: UCB 
LENGTH OF ENTRY 



FILE CONTROL BLOCK 



.=0 

F . LINK : 
F.FNUM: 
F.FSEQ: 

F.FSQN: 
F . FOWN : 
F.FPRO: 
F.UCHA: 
F.SCHA: 
F . HDLB : 



.ASECT 



'L' .BLKW 
•L' .BLKW 
•L ' .BLKW 

.BLKB 
'L' .BLKB 
'L' .BLKW 
'L' .BLKW 
'L 1 .BLKB 
•L ' .BLKB 
•L' .BLKW 



FCB CHAIN POINTER 
FILE NUMBER 
FILE SEQUENCE NUMBER 
NOT USED 

FILE SEGMENT NUMBER 

FILE OWNER'S UIC 

FILE PROTECTION CODE 

USER CONTROLLED CHARACTERISTICS 

SYSTEM CONTROLLED CHARACTERISTICS 

FILE HEADER LOGICAL BLOCK NUMBER 
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F.LBN: 'L* .BLKW 2 

F.SIZE: 'L' .BLKW 2 
F.NACS: 'L' .BLKB 1 
F.NLCK: 'L' .BLKB 1 
S.STBK= I B' .-F.LBN 



BEGINNING OF STATISTICS BLOCK 

LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS 

IF NON CONTIGUOUS 

SIZE OF FILE IN BLOCKS 

NO. OF ACCESSES 

NO. OF LOCKS 

SIZE OF STATISTICS BLOCK 



F.STAT: 
F . NWAC : 



F.DREF: 
F.DRNM: 
F.FEXT: 
F.FVBN: 
F.LKL: ' 
F.WIN: ' 
F . LGTH : 



'L' 

1 L * .BLKB 1 
.BLKB 1 
FC.WAC='B I 
FC.DIR= 'B ' 
FC.CEF='B' 
FC . FCO= ' B 1 

'L • .BLKW 

'L' .BLKW 

' L 1 .BLKW 

'L' .BLKW 

L' .BLKW 

L' .BLKW 

•L' 



100000 
40000 
20000 
10000 



FCB STATUS WORD 
NUMBER OF WRITE ACCESSORS 
STATUS BITS FOR FCB CONSISTING OF 
SET IF FILE ACCESSED FOR WRITE 
SET IF FCB IS IN DIRECTORY LRU 
SET IF DIRECTORY EOF NEEDS UPDATING 
SET IF TRYING TO FORCE DIRECTORY CONTIG 
DIRECTORY EOF BLOCK NUMBER 
1ST WORD OF DIRECTORY NAME 
POINTER TO EXTENSION FCB 
STARTING VBN OF THIS FILE SEGMENT 
POINTER TO LOCKED BLOCK LIST FOR FILE 
WINDOW BLOCK LIST FOR THIS FILE 
SIZE IN BYTES OF FCB 



WINDOW 



.ASECT 



.=0 



W.ACT: 'L 1 

W.BLKS: 'L • 

W.CTL: 'L' .BLKW 1 



NUMBER OF ACTIVE MAPPING POINTERS 

WHEN NO SECONDARY POOL 
BLOCK SIZE OF SECONDARY POOL SEGMENT 

WHEN SECONDARY POOL 
LOW BYTE = # OF MAP ENTRIES ACTIVE 
HIGH BYTE CONSISTS OF CONTROL BITS 



WI 


.RDV= 


'B ■ 


400 


; READ VIRTUAL BLOCK ALLOWED IF SET 


WI 


.WRV= 


•B' 


1000 


; WRITE VIRTUAL BLOCK ALLOWED IF SET 


WI 


.EXT = 


'B' 


2000 


EXTEND ALLOWED IF SET 


WI 


.LCK = 


'B' 


4000 


; SET IF LOCKED AGAINST SHARED ACCESS 


WI 


. DLK = 


B' 


10000 


; SET IF DEACCESS LOCK ENABLED 


WI 


. PND = 


•B' 


20000 


} WINDOW TURN PENDING BIT 


WI 


,EXL = 


B' 


40000 


; SET IF MANUAL UNLOCK DESIRED 


WI .WCK= 


'B' 


100000 


? DATA CHECK ALL WRITES TO FILE 



W. IOC: 'L' .BLKB 

.BLKB 
W.FCB: 'L' .BLKW 
W.TCB: 'L' .BLKW 
W.UCB: 'L* .BLKW 
W.LKL: 'L' .BLKW 
W.WIN: 'L' .BLKW 

.IF 

.IF 



COUNT OF I/O THROUGH THIS WINDOW 
RESERVED 

FILE CONTROL BLOCK ADDRESS 
TCB ADDRESS OF ACCESSOR 
ORIGINAL UCB ADDRESS OF DEVICE 
POINTER TO LIST OF USERS LOCKED BLOCKS 
WINDOW BLOCK LIST LINK WORD 



NB , SYSDEF ; IF SYSDEF SPECIFIED IN CALL 
NDF,P$$WND ; IF SECONDARY POOL WINDOWS NOT ALLOWED 
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NON-SECONDARY POOL WINDOW BLOCK 

IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK 
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS. 



W.VBN: ' L' .BLKB 1 
W.MAP: 'L 1 
W.WISZ: 'L' .BLKB 1 
.BLKW 1 
W.RTRV: 'L' 

W.SLEN='B'-4 



.IFF 



HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 

DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD REFS 

SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

DUMMY DEFINITION TO PREVENT INCORRECT REFERENCE 
(-4 WHEN ROUNDED "UP" IS A VERY LARGE BLOCK) 

IF WINDOWS IN SECONDARY POOL 



SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS 
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE 
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION 
FOR THE SECONDARY POOL WINDOW. 



W.MAP: 'L' .BLKW 
W.SLEN: 'L' 



ADDR TO THE MAPPING PTRS IN SECONDARY POOL 
LENGTH OF PRIMARY POOL STUB 



SECONDARY POOL WINDOW 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL 
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING 
FORMAT . 



.=0 



ASSUME W.CTL,0 



.BLKB 1 

W. USE: 'L' .BLKB 1 

W.VBN: 'L' .BLKB 1 

W.WISZ: 'L' .BLKB 1 

.BLKW 1 
W.RTRV: 'L' 

. ENDC 

. ENDC 



NUMBER OF ACTIVE MAPPING POINTERS 
STATUS OF BLOCK 

HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
SIZE IN RTRV PTRS OF WINDOW (7 BITS) 
LOW ORDER WORD OF 1ST VBN MAPPED 
OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

; END SECONDARY POOL WINDOW CONDITIONAL 

; END SYSDEF CONDITIONAL 



LOCKED BLOCK LIST NODE 



.ASECT 



= 
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L.LNK: ' L ' . BLKW 1 

L . WI 1 : 1 L ' .BLKW 1 

L. VB1: *L' . BLKB 1 

L.CNT: 'L • .BLKB 1 

.BLKW 1 
L.LKSZ: 'L 1 



LINK TO NEXT NODE IN LIST 
POINTER TO WINDOW FOR FIRST ENTRY 
HIGH ORDER VBN BYTE 
COUNT FOR ENTRY 
LOW ORDER VBN 



; END OF DEFINITIONS 



.PSECT 

.MACRO F11DF$ X,Y,Z 

. ENDM F11DF$ 

. ENDM F11DF$ 
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HDRDF$ 



TASK HEADER OFFSET DEFINITIONS 



.ASECT 





= 








IT 

H 


.CSP: 


L' 


. BLKW 


1 


TJ 

n 


. HDLN : " L 


' . BLKW 


1 


U 

n 


. SMAP : " L 


1 or vo 
. BLKb 


1 


H 


. DMAP 


'L 


* .BLKB 


1 


TJ 

n 


. FMAP : 'L 


1 .BLKW 


1 


IT 

n 


.CUIC 


'L 


1 or T/r»7 

. BLKW 


1 


IT 

H 


.DUIC 


"L 


1 .BLKW 


1 


IT 

n 


. IPS-: 


L 1 


. bLKW 


1 


n 


. IPC: 


L 1 




1 


TJ 

n 


.ISP: 


1 L * 


. BLKW 


1 


TJ 

n 


.ODVA 


: 1 L 


1 .BLKW 


1 


H 


.ODVL 


' 'L 


' .BLKW 


1 


H 


. TKVA 


"L 


' .BLKW 


1 


TJ 

H 


. TKVL 


■ ' L 


' . BLKW 


1 


TJ 

n 


.PFVA 


. ' L 


1 .BLKW 


1 


H 


.FPVA 


' L 


* .BLKW 


1 


U 

n 


.RCVA 


' L 


' .BLKW 


1 


ij 
n 


.EFSV 


: 1 L 


' .BLKW 


1 


TJ 

H 


.FPSA 


1 L 


1 .BLKW 


1 


H 


. WND : 


1 L ' 


.BLKW 


1 


H 


.DSW: 


L ' 


.BLKW 


1 


H 


.FCS: 


' L ' 


.BLKW 


1 


H 


.FORT: 1 L 


1 .BLKW 


1 


H 


.OVLY: ' L 


' .BLKW 


1 


H 


.VEXT: 'L 


1 .BLKW 


1 


H 


.SPRI : 'L 


' .BLKB 


1 


H 


. NML : 


' L * 


.BLKB 


1 


H 


. RRVA : ' L 


' .BLKW 


1 


H 


.X25: 


'L' 


.BLKB 


1 






.BLKB 


1 








BLKW 


2 


H 


. GARD : ' L 


' .BLKW 


1 


H 


. NLUN: * L 


' .BLKW 


1 


H 


. LUN : 


L 1 


.BLKW 


2 



CURRENT STACK POINTER 

HEADER LENGTH IN BYTES 

SUPERVISOR D SPACE OVERMAP MASK 

USER D SPACE OVERMAP MASK 

POINTER TO FAST MAP SECTION OF HDR 

CURRENT TASK UIC 

DEFAULT TASK UIC 

INITIAL PROCESSOR STATUS WORD (PS) 

INITIAL PROGRAM COUNTER (PC) 

INITIAL STACK POINTER (SP) 

ODT SST VECTOR ADDRESS 

ODT SST VECTOR LENGTH 

TASK SST VECTOR ADDRESS 

TASK SST VECTOR LENGTH 

POWER FAIL AST CONTROL BLOCK ADDRESS 
FLOATING POINT AST CONTROL BLOCK ADDRESS 
RECIEVE AST CONTROL BLOCK ADDRESS 
EVENT FLAG ADDRESS SAVE ADDRESS 
POINTER TO FLOATING POINT/EAE SAVE AREA 
POINTER TO NUMBER OF WINDOW BLOCKS 
TASK DIRECTIVE STATUS WORD 
FCS IMPURE POINTER 
FORTRAN IMPURE POINTER 
OVERLAY IMPURE POINTER 
WORK AREA EXTENSION VECTOR POINTER 
PRIORITY DIFFERENCE FOR SWAPPING 
NETWORK MAILBOX LUN 

RECEIVE BY REFERENCE AST CONTROL BLOCK 

ADDRESS 
FOR USE BY X25 SOFTWARE 
5 RESERVED BYTES 

POINTER TO HEADER GUARD WORD 

NUMBER OF LUN ' S 

START OF LOGICAL UNIT TABLE 



LENGTH OF FLOATING POINT SAVE AREA 



H.FPSL='B , 25.*2 



WINDOW BLOCK OFFSETS 



.=0 

W.BPCB: 'L ■ .BLKW 1 
W.BLVR: 'L' .BLKW 1 
W.BHVR: 'L' .BLKW 1 
W.BATT: 'L 1 .BLKW 1 
W.BSIZ: 'L' .BLKW 1 



; PARTITION CONTROL BLOCK ADDRESS 
;LOW VIRTUAL ADDRESS LIMIT 
;HIGH VIRTUAL ADDRESS LIMIT 
; ADDRESS OF ATTACHMENT DESCRIPTOR 
;SIZE OF WINDOW IN 32W BLOCKS 
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W.BOFF: 1 L ' . BLKW 1 
W.BFPD: 'L' .BLKB 1 
W.BNPD: * L ' .BLKB 1 
W.BLPD: f L' .BLKW 1 
W.BLGH: 'L' 



; PHYSICAL MEMORY OFFSET IN 32W BLOCKS 

; FIRST PDR ADDRESS 

; NUMBER OF PDR ' S TO MAP 

;CONTENTS OF LAST PDR 

; LENGTH OF WINDOW DESCRIPTOR 



BIT DEFINITION FOR W.BLPD 



WB.NBP='B'20 
WB.BPS='B'40 



;CACHE BYPASS NOT DESIRED FOR THIS WINDOW 
; ALWAYS BYPASS THE CACHE FOR THIS WINDOW 



.PSECT 

.MACRO HDRDF$ X,Y 
. ENDM 
. ENDM 
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.MACRO HWDDF$,L,B 



MACROS FOR DEFINING MAPPING REGISTER DEFINITIONS 



$$$ = 



.MACRO CRESET NAM , ADDR 
.REPT 8. 

CRENAM NAM,ADDR+<$$$2>,$$$ 



$$$=$$$+1 

• ENDR 
. ENDM 

.MACRO CRENAM NAM, ADDR, N 
'NAM 1 'N ' = : =ADDR 
. ENDM 



HARDWARE REGISTER ADDRESSES AND STATUS CODES 



MPCSR='B'177746 

MPAR='B' 172100 

PIRQ='B'177772 

PR0='B'0 

PR1='B , 40 

PR4='B'200 

PR5='B'240 

PR6='B'300 

PR7='B'340 

PS='B'177776 

SWR='B I 177570 

TPS='B'177564 



ADDRESS OF PDP-11/70 MEMORY PARITY 
REGISTER 

ADDRESS OF FIRST MEMORY PARITY REGISTER 

PROGRAMMED INTERRUPT REQUEST REGISTER 

PROCESSOR PRIORITY 

PROCESSOR PRIORITY 1 

PROCESSOR PRIORITY 4 

PROCESSOR PRIORITY 5 

PROCESSOR PRIORITY 6 

PROCESSOR PRIORITY 7 

PROCESSOR STATUS WORD 

CONSOLE SWITCH AND DISPLAY REGISTER 
CONSOLE TERMINAL PRINTER STATUS REGISTER 



EXTENDED ARITHMETIC ELEMENT REGISTERS 



.IF DF E$$EAE 



AC='B'177302 
MQ='B'177304 
SC= , B , 177310 

. ENDC 



ACCUMULATOR 

; MULTIPLIER -QUOTIENT 

;SHIFT COUNT 



MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES 



.IF NB B 



CRESET 
CRESET 
CRESET 
CRESET 



KINAR, 172340 
KINDR, 172300 
KDSAR, 172360 
KDSDR, 172320 



; KERNEL I PAR'S 
; KERNEL I PDR'S 
; KERNEL D PAR'S 
; KERNEL D PDR'S 
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CRESET 


SISAR, 172240 






b ISDR , 1/2200 




CRESET 


SDSAR, 172260 










CRESET 


UINAR, 177640 




CRESET 


UINDR, 177600 




CRESET 


UDSAR , 1 / /bbO 




CRESET 


LJDSDR, 177620 




. ENDC 






.IF NB 


SYSDEF 




.IF DF 


KS SnA^ 

X\ V V **k>J 




v— • r\ i_i o i 


KT9AR 1 79^60 




CRESET 


KISDR, 172320 




. IFF 






CRESET 


KISAR ,172340 




CRESET 


KISDR, 172300 




. ENDC 






. IF DF 


U$$DAS 




CRESET 


UISAR, 177660 




CRESET 


UISDR, 177620 




. IFF 


; DF U$$DAS 




CRESET 


UISAR, 177640 




CRESET 


UISDR, 177600 




.ENDC 


; DF U$$DAS 




.ENDC 




UBMPR= 


'B 1 170200 




CMODE= 


'B • 140000 




PMODE= 


■B'30000 




CSMODE 


= , BM0000 




PSMODE 


='B'10000 




SR0='B 


•177572 




SR3='B 


'172516 




CPUERR 


= , B , 177766 




MEMERR 


='B'177744 




MEMCTL 


='B'177746 




; + 

; DEFI 


NE THE LOCATIONS USED IN 


; FOR 


XT SYSTEMS 




N. KEY= 


'B'173054 




N.UPT= 


'B ' 173064 




N.DZA= 


■B '173074 




N.DWA= 


'B ' 173104 




N . DAY= 


'B'173114 




N.MON= 


•B' 173116 




N. YEA= 


'B'173120 





SUPERVISOR I PAR'S 
; SUPERVISOR I PDR'S 
; SUPERVISOR D PAR'S 
; SUPERVISOR D PDR'S 
;USER I PAR'S 
;USER I PDR'S 
;USER D PAR'S 
;USER D PDR'S 



; KERNEL D PAR'S 
; KERNEL D PDR'S 



; KERNEL I PAR'S 
; KERNEL I PDR'S 



;USER D PAR'S 
;USER D PDR'S 



;USER I PAR'S 
;USER I PDR'S 



UNIBUS MAPPING REGISTER 

CURRENT MODE FIELD OF PS WORD 

PREVIOUS MODE FIELD OF PS WORD 

CURRENT MODE = SUPERVISOR PS WORD BITS 

PREVIOUS MODE = SUPERVISOR PS WORD BITS 

SEGMENT STATUS REGISTER 

SEGMENT STATUS REGISTER 3 

CPU ERROR REGISTER 

MEMORY SYSTEM ERROR REGISTER 

MEMORY CONTROL REGISTER 



NUMBER OF KEYS PRESSED 

UPTIME IN MINUTES 

NUMBER OF I/OS DONE ON THE DZ 

NUMBER OF I/OS DONE ON THE DW 

DATE THAT THE NVR WAS LAST INITIALIZED 
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+ 

FEATURE SYMBOL DEFINITIONS 



FE 


.EXT = 


'B 


•1 


22-BIT EXTENDED MEMORY SUPPORT 


FE 


.MUP = 


'B 


•2 


■MULTI-USER PROTECTION SUPPORT 


FE 


.EXV= 


'B 


'4 


EXECUTIVE IS SUPPORTED TO 20K 


FE 


.DRV= 


'B 


'10 


LOADABLE DRIVER SUPPORT 


FE 


.PLA= 


'B 


'20 , 


PLAS SUPPORT 


FE.CAL= 


•B 


'40 


DYNAMIC CHECKPOINT SPACE ALLOCATION 


FE 


. PKT = 


'B 


•100 


PREAL LOCATION OF I/O PACKETS 


FE 


. EXP = 


•B 


•200 


EXTEND TASK DIRECTIVE SUPPORTED 


FE 


.LSI = 


B 


•400 


PROCESSOR IS AN LSI-11 


FE 


.OFF = 


'B 


'1000 , 


PARENT/OFFSPRING TASKING SUPPORTED 


FE 


. FDT = 


B 


'2000 , 


FULL DUPLEX TERMINAL DRIVER SUPPORTED 


FE 


.X25 = 


•B 


'4000 


X.25 CEX IS LOADED 


FE 


. DYM = 


B 


•10000 ; 


DYNAMIC MEMORY ALLOCATION SUPPORTED 


FE 


.CEX= 


'B 


'20000 


COM EXEC IS LOADED 


FE 


.MXT = 


B 


•40000 


MCR EXIT AFTER EACH COMMAND MODE 


FE 


. NLG = 


'B 


'100000 , 


LOGINS DISABLED - MULTI-USER SUPPORT 



+ 

FEATURE MASK DEFINITIONS (SECOND WORD) 



F2. 


DAS = 


B' 


1 , 


KERNEL DATA SPACE SUPPORTED 


F2. 


LIB= 


B' 


2 


SUPERVISOR MODE LIBRARIES SUPPORTED 


F2. 


MP='B*4 




SYSTEM SUPPORTS MULTIPROCESSING 


F2. 


EVT = 


B' 


10 


SYSTEM SUPPORTS EVENT TRACE FEATURE 


F2. 


ACN= 


B' 


20 


SYSTEM SUPPORTS CPU ACCOUNTING 


F2. 


SDW= 


■B' 


40 


SYSTEM SUPPORTS SHADOW RECORDING 


F2. 


POL = 


B' 


100 


SYSTEM SUPPORTS SECONDARY POOLS 


F2. 


WND = 


'B' 


200 


•SYSTEM SUPPORTS SECONDARY POOL FILE WINDOWS 


F2. 


DPR = 


B' 


400 


SYSTEM HAS A SEPARATE DIRECTIVE PARTITION 


F2. 


IRR = 


'B' 


1000 


INSTALL, RUN, AND REMOVE SUPPORT 


F2. 


GGF = 


B' 


2000 


GROUP GLOBAL EVENT FLAG SUPPORT 


F2. 


RAS = 


•B' 


4000 


; RECEIVE/SEND DATA PACKET SUPPORT 


F2. 


AHR= 


'B' 


10000 


■ALT. HEADER REFRESH AREA SUPPORT 


F2. 


RBN= 


'B' 


20000 


GROUND ROBIN SCHEDULING SUPPORT 


F2. 


SWP= 


B' 


40000 


EXECUTIVE LEVEL DISK SWAPPING SUPPORT 


F2. 


STP = 


'B' 


100000 


EVENT FLAG MASK IS IN THE TCB(1=YES) 


; + 

; THIRD 


FEATURE MASK SYMBOL DEFINITIONS 


F3. 


CRA = 


B' 


1 


SYSTEM SPONTANEOUSLY CRASHED (1=YES) 


F3. 


XCR = 


'B' 


2 


■SYSTEM CRASHED FROM XDT (1=YES) 


F3. 


EIS = 


B" 


4 


SYSTEM REQUIRES EXTENDED INSTRUCTION SET 


F3. 


STM = 


'B' 


10 


SYSTEM HAS SET SYSTEM TIME DIRECTIVE 


F3. 


UDS = 


B' 


20 


SYSTEM SUPPORTS USER DATA SPACE 


F3. 


PRO= 


'B ' 


40 


SYSTEM SUPPORTS SEC. POOL PROTO TCBS 


F3. 


XHR= 


B' 


100 


SYSTEM SUPPORTS EXTERNAL TASK HEADERS 


F3. 


AST = 


B 1 


200 


SYSTEM HAS AST SUPPORT 


F3. 


11S = 


B ' 


400 


RSX-11S SYSTEM 


F3. 


CLI = 


B ' 


1000 


•MULTIPLE CLI SUPPORT 


F3. 


TCM= 


B 1 


2000 


SYSTEM HAS SEPARATE TERMINAL DRIVER POOL 


F3. 


PMN = 


•B 


4000 


SYSTEM SUPPORTS POOL MONITORING 


F3. 


WAT = 


B " 


10000 


SYSTEM HAS WATCHDOG TIMER SUPPORT 


F3. 


RLK= 


'B 1 


20000 


SYSTEM SUPPORTS RMS RECORD LOCKING 


F3. 


SHF = 


B " 


40000 


SYSTEM SUPPORTS SHUFFLER TASK 
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FOURTH FEATURE MASK BITS 



F4. 


CXD = 


'B 


•1 


F4. 


XT= ' 


B' 


2 


F4. 


ERL = 


'B 


•4 


F4. 


PTY = 


•B 


'10 


F4. 


DVN= 


'B 


"20 


F4. 


LCD = 


'B 


•40 


F4. 


NIM = 


'B 


'100 


F4.CHE= 


"B 


•200 


F4. 


LOG= 


•B 


•400 


F4. 


NAM = 


•B 


■1000 


F4. 


FMP = 


'B 


'2000 


F4. 


DCL = 


'B 


'4000 


F4. 


DDS = 


'B 


•10000 


F4. 


ACD = 


•B 


' 20000 



COMM EXEC IS DEALLOCATED (NON-I/D ONLY) 

SYSTEM IS AN XT SYSTEM (1=YES) 

SYSTEM SUPPORTS ERROR LOGGING (1=YES) 

SYSTEM SUPPORTS PARITY MEMORY (1=YES) 

SYSTEM SUPPORTS DECIMAL VERSIONS (1=YES) 

SYSTEM SUPPORTS LOADABLE CRASH (1=YES) 

SYSTEM SUPPORTS DELETED TASK IMAGES (1=YES) 

SYSTEM SUPPORTS DISK DATA CACHING (1=YES) 

SYSTEM SUPPORTS LOGICAL NAMES (1=YES) 

SYSTEM SUPPORTS NAMED DIRECTORIES (1=YES) 

SYSTEM SUPPORTS FAST MAP DIRECTIVE 

DCL IS DEFAULT CLI (1=YES) 

NAMED DIRECTORY MODE IS THE DEFAULT (1=YES) 

SYSTEM SUPPORTS ACD ' S 



HARDWARE FEATURE MASK BIT DEFINITIONS 

HF.CIS,HF.FPP DEFINED AS SIGN BITS FOR RUN TIME SPEED 



HF.UBM='B'l 

HF.EIS='B'2 

HF.QB='B'4 

HF . DSP= 'B * 10 

HF.CIS='B , 200 

HF . FPP= ' B ' 100000 



PROCESSOR HAS A UNIBUS MAP (1=YES) 
PROCESSOR HAS EXTENDED INSTRUCION SET 
SYSTEM HAS A QBUS (1=YES) 
HARDWARE SUPPORTS DATA SPACE 

PROCESSOR SUPPORTS COMMERCIAL INSTRUCTION SET 
(l=PROC. HAS NO FLOATING POINT UNIT) 



SECOND HARDWARE FEATURE MASK BIT DEFINITIONS 
THIS WORD IS RESERVED FOR XT HARDWARE FEATURES 



H2.NVR='B I 1 
H2. INV= 'B 1 2 
H2.CLK='B'4 
H2 . ITF= 'B ' 10 

H2.PRO= 'B ' 20 
H2.BRG='B'100000 



;XT NON-VOLATILE RAM PRESENT (1=YES) 

; NON-VOLATILE RAM IS INVALID (1=YES) 

;XT CLOCK IS PRESENT (1=YES) 

; INVALID TIME FORMAT IN NON-VOLATILE RAM 

; (1=YES) 

; RUNNING ON PRO/3XX HARDWARE 

;XT BRIDGE MODULE PRESENT (1=YES) 



SYSGEN FEATURE SELECTIONS MASK. THIS IS INTENDED TO RECORD IN A 
BIT MASK THE CHOICES MADE AT SYSGEN TIME. FEATURES ARE LISTED HERE FOR 
OUR INFORMATIONAL PURPOSES ONLY. THEY CANNOT BE TESTED LIKE BITS IN THE 
FEATURE MASK SINCE THIS ONLY EXISTS IN THE RSXllM.STB FILE. NO BITS IN 
MEMORY ; ARE USED. THEY ARE ONLY INTENDED TO BE PRINTED FROM THE STB FILE 
BY CDA. 



SF . STD= ' B 1 1 
SF.PGN='B'2 



; STANDARD EXEC SELECTED 
; SYSTEM WAS PRE-GENERATED 
; (EX. RL02/RC25 SYSTEM) 
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MULTIPROCESSOR STATUS TABLE DEFINITIONS (TEMPORARY) 



MP.CRH='B , 100000 

MP.PWF='B'40000 

MP.RSM='B'20000 

MP.NOP='B'10000 

MP.STP='B'4 

MP.INT='B , 7777 



;CRASH PROCESSOR IMMEDIATELY 

JPOWERFAIL ON ONE CPU 

; RESET INTERRUPT MASKS 

;NOP FUNCTION FOR TRANSMISSION CHECK 

;STOP PROCESSOR IN ORDERLY FASHION 

;BIC MASK FOR INTERRUPT LVL FUNCTIONS 



.MACRO 
. ENDM 
. ENDM 



HWDDF$ X,Y,Z 
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.MACRO ITBDF$ L,B 



INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS 



.IF DF A$$TRP 



.MCALL PKTDF$ 
PKTDF$ 

. ENDC 

.ASECT 
.=0 

X.LNK: 'L ■ .BLKW 1 
X. JSR: 'L' JSR R5,@ 
X.PSWr'L 1 .BLKB 1 
. BLKB 1 
X. ISR: 'L' .BLKW 1 
X.FORK: 'L' 

.BLKW 1 
.BLKW 1 
.BLKW 1 
.BLKW 1 

.IF DF M$$MGE 

X.REL: 'L' .BLKW 1 

. ENDC 

X.DSI : 'L' .BLKW 1 
X.TCB: 'L' .BLKW 1 

.IF NB SYSDEF 

.IF DF A$$TRP 

.BLKW 1 
X.AST: 'L' .BLKB A.PRM 

.ENDC 
X.VEC: 'L' .BLKW 1 

X.VPC: 'L' .BLKW 1 
X.LEN: 'L' 

.ENDC 

.PSECT 

.MACRO ITBDF$ X,Y,Z 
. ENDM ITBDF$ 



; DEFINE AST BLOCK OFFSETS 



LINK WORD FOR ITB LIST STARTING IN TCB 
CALL $INTSC 

LOW BYTE OF PSW FOR ISR 
UNUSED 

ISR ENTRY POINT (APR5 MAPPING) 

FORK BLOCK 

THREAD WORD 

FORK PC 

SAVED R5 

SAVED R4 



RELOCATION BASE FOR APR5 



ADDRESS OF DIS.INT. ROUTINE 
TCB ADDRESS OF OWNING TASK 



A.DQSR FOR AST BLOCK 
AST BLOCK 



VECTOR ADDRESS (IF AST SUPPORT, 
THIS IS FIRST AND ONLY AST PARAMETER) 
SAVED VECTOR PC 
LENGTH IN BYTES OF ITB 
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/ .MACRO 



KRBDF$ 



CONTROLLER REQUEST BLOCK (KRB) 

THE CONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A DEVICE 
CONTROLLER. EXACTLY ONE KRB EXISTS FOR EVERY DEVICE CONTROLLER 
IN AN RSX-11M+ SYSTEM. THE KRB CONTAINS CERTAIN DEVICE STATUS 
INCLUDING THE CSR AND VECTOR ADDRESS FOR THE CONTROLLER. 







.ASECT 








.=17777 









177770 


K . PRM : 


• BLKW 


1 


; DEVICE DEPENDANT PARAMETER WORD 


177772 


K.PRI : 


. BLKB 


1 


/CONTROLLER PRIORITY 


177773 


K.VCT: 


. BLKB 


1 


; INTERRUPT VECTOR ADDRESS 


177774 


K.CON: 


.BLKB 


1 


/CONTROLLER INDEX WITHIN THE SYSTEM 


177775 


K. IOC: 


.BLKB 


1 


/CONTROLLER I/O COUNT 


177776 


K.STS: 


. BLKW 


1 


/CONTROLLER STATUS 


000000 


K.CSR: 


.BLKW 


1 


/ADDRESS OF CONTROL STATUS REGISTER 




; NOTE: 


K.CSR 


MUST BE 


THE ZERO OFFSET! 


000002 


K. OFF : 


.BLKW 


1 


/OFFSET TO UCB/UMR/RHBAE TABLE 


000004 


K.HPU: 


.BLKB 


1 


/HIGHEST PHYSICAL UNIT NUMBER 


000005 




.BLKB 


1 


/UNUSED BYTE 


000006 


K . OWN : 


.BLKW 


1 


/OWNER OF CONTROLLER 


000010 


K.CRQ: 


.BLKW 


2 


/CONTROLLER REQUEST QUEUE 


000014 


K.URM: 


.BLKW 


1 


/CONTROLLER UNIBUS RUN MASK 


000016 


K.FRK: 


.BLKW 


1 


/POSSIBLE KRB FORK BLOCK 



OFFSETS FOR THE KRB EXTENSION REACHED BY ADDING (K.OFF) TO 
THE STARTING ADDRESS OF THE KRB. 



DEFINE OFFSETS IN SCB/KRB FOR DISK MSCP CONTROLLERS 



.=-20. 

177754 KE.UMH: .BLKW 

177760 KE.UMC: .BLKW 

.=177776 
177776 KE.RHB: .BLKW 



/LIST HEAD FOR UMR WAITING ASSIGNMENT 
/BLK (S) 

/COUNT OF AVAILABLE UMR WAITING 
/ASSIGNMENT BLOCK (S) 

/OFFSET TO RHBAE REGISTER (IF ANY) 



WHEN ONE ADDS (K.OFF) TO THE KRB ADDRESS, IT YIELDS AN 
ADDRESS WHICH POINTS TO HERE. 



000000 KE.UCB: .BLKW 1 
.PSECT 



/OFFSET TO UCB TABLE (IF KS.UCB SET) 
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CONTROLLER REQUEST BLOCK (KRB) STATUS BIT DEFINITIONS 



KS 


. OFL = 


1 


KS 


.MOF = 


2 


KS 


. UOP = 


4 


KS 


.MBC = 


10 


KS 


.SDX = 


20 


KS 


. POE = 


40 


KS 


.UCB = 


100 


KS 


• DIP = 


200 


KS 


. PDF = 


400 


KS 


.EXT = 


1000 


KS 


.SLO = 


2000 



CONTROLLER OFFLINE (1=YES) 
CONTROLLER MARKED FOR OFFLINE (1=YES) 
SUPPORTS OVERLAPPED OPERATION (1=YES) 
DEVICE IS MASSBUS CONTROLLER (1=YES) 
SEEKS ALLOWED DURING DATA XFERS (1=YES) 
PARALLEL OPERATION ENABLED (1=YES) 
UCB TABLE PRESENT (1=YES) 
DATA TRANSFER IN PROGRESS (1=YES) 
PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY 
BLOCK (S) (1=YES) 

EXTENDED 22-BIT UNIBUS CONTROLLER 
BLOCK (S) ; (1=YES) 

CONTROLLER IS SLOW COMING ONLINE 
BLOCK (S) (1=YES) 



DEFINE THE CONTIGUOUS SCB OFFSETS 







.ASECT 








.=177762 








177762 


S.PRI : 


.BLKB 


1 


CONTROLLER PRIORITY 


177763 


S . VCT : 


. BLKB 


1 


; INTERRUPT VECTOR ADDRESS 


177764 


S.CON: 


.BLKB 


1 


CONTROLLER INDEX 


177765 




.BLKB 


1 




177766 




.BLKW 


1 




177770 


S.CSR: 


.BLKW 


1 


CONTROL AND STATUS REGISTER 


177772 




.BLKW 


1 




177774 




.BLKB 


1 




177775 




.BLKB 


1 




177776 


S.OWN: 


.BLKW 


1 


^•DISTRIBUTED CNTBL 



SUBCONTROLLER REQUEST BLOCK (KRBl) 

THE SUBCONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A 
DEVICE SUBCONTROLLER. EXACTLY ONE KRBl EXISTS FOR EVERY DEVICE 
SUBCONTROLLER IN AN RSX-11M+ SYSTEM. 







.ASECT 








.=-4 








177774 


Kl.CON: 


.BLKB 


1 


; SUBCONTROLLER INDEX WITHIN THE SYSTEM 


177775 




.BLKB 


1 


; UNUSED BYTE 


177776 


Kl.STS: 


.BLKW 


1 


; SUBCONTROLLER STATUS 


000000 


Kl.MAS: 


.BLKW 


1 


;UCB ADDRESS OF THE MASTER UNIT 




; NOTE: 


Kl.MAS 


MUST BE 


THE ZERO OFFSET 


000002 


Kl . OWN : 


.BLKW 


1 


; OWNER OF SUBCONTROLLER 


000004 


Kl.CRQ: 


.BLKW 


2 


; SUBCONTROLLER REQUEST QUEUE 


000010 


Kl.UCB: 






; START OF THE UCB TABLE (IF ANY) 



.PSECT 
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r • 



MACRO 



LCBDF$ 



LOGICAL ASSIGNMENT CONTROL BLOCK 

THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO 
ASSOCIATE A LOGICAL NAME WITH A PHYSICAL DEVICE UNIT. 
LOGICAL CONTROL BLOCKS ARE LINKED TO FORM THE LOGICAL 
ASSIGNMENTS OF A SYSTEM. LOGICAL ASSIGNMENTS CAN BE MADE 
ON A SYSTEM-WIDE OR LOCAL (TERMINAL) BASIS. 



.ASECT 



.=0 



000000 
000002 
000004 
000005 
000006 
000010 
000012 



L.LNK: 
L . NAM : 
L.UNIT: 
L . TYPE : 
L . UCB : 
L.ASG: 
L.LGTH= 



.BLKW 
. BLKW 
. BLKB 
. BLKB 
.BLKW 
.BLKW 
.-L.LNK 



1 
1 
1 
1 
1 
1 



; LINK TO NEXT LCB 

; LOGICAL NAME OF DEVICE 

; LOGICAL UNIT NUMBER 

; TYPE OF ENTRY (0=SYSTEM WIDE) 

;TI UCB ADDRESS 

; ASSIGNMENT UCB ADDRESS 

; LENGTH OF LCB 



.PSECT 
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.MACRO MTADF$,L,B 
.ASECT 

ANSI MAGTAPE SPECIFIC DATA STRUCTURES 
VOLUME SET CONTROL BLOCK OFFSET DEFINITIONS (VSCB) 
VOLUME SET AND PROCESS CONTROL SECTION 
= 



V.TCNT: 'L ' 


.BLKW 


1 


•TRANSACTION COUNT 


V.TYPE: 'L' 


. BLKB 


1 


;VOLUME TYPE DESCRIPTOR 


V.VCHA: 'L' 


• BLKB 


1 


;VOLUME CHARACTERISTICS 


V.LABL: 'L' 


.BLKB 


12. 


;FILE SET ID (FIRST SIX BYTES) 


V.NXT: 


L' 


.BLKW 1 




;PTR TO NEXT VSCB NODE 


V.MVL: 


'L' 


.BLKW 1 




; PTR TO MOUNTED VOL LIST 


V.UVL: 


L' 


.BLKW 1 




;PTR TO UNMOUNTED VOL LIST 


V.ATL: 


'L' 


.BLKW 1 




;ATL ADDR OF ACCESSING TASK 










; TCB IN RSX11M 


V.UCB: 


1 L 1 


.BLKW 1 




; ADDR OF CURRENT UCB OR PUD 


V.RVOL 


'L* 


.BLKB 


1 


•CURRENT RELATIVE VOL # 

J V— \J X\ X\. JJLl 1 XX l~i i-J fl X -L V X-J V \J i-J 7f 


V.MOU: 


'L' 


.BLKB 1 




•MOUNT MODE BYTE 

r 1 1 \y Ull 1 11 v JL/ i-J XJ> i 1 U 


V.TCHR 


'L' 


.BLKW 


1 


• riTNT CHAR FOR ATI. rTNTTc; ncpn FOR VOf 


V.SEQN 


: 'L' 


.BLKW 


1 


•CTIRRENT FILE SEOHENCE # 

f \J JL\ x\ xll LH X i- X. 1—1 ill KJ 1-1 \£ KJ XJ >w XJ 7T 


V.SECN 


'L' 


.BLKW 


1 


;CURRENT FILE SECTION # 


V.TPOS 


: 'L' 


.BLKB 


1 


;POSITION OF TAPE IN TM'S TO NXT HDR1 


V. PSTA 


• 'L' 


.BLKB 


1 


; PROCESS STATUS BYTE 


V.TIMO 


•L' 


.BLKW 


1 


; BLOCKED PROCESS TIMEOUT COUNTER 


V.STAT 


'L' 


.BLKW 


3 


; STATUS WORDS USED BY COMMAND 










; EXECUTION MODULES 


V.TRTB: 'L' 


.BLKB 


1 


; TRANSLATION CONTROL BYTE 


V. EFTV 


•L' 


.BLKB 


1 


:FOR MAG TO RETURN IE EOF. EOT. EOV 

f J- \S i-\ I ll\\J X J. v i_J X \J L\ LM X. l_J • XJ *_/ X. f XJ V X f J_J <w/ V 


; LABEL DATA SECTION 




V.BLKL 


' L 1 


.BLKW 


1 




V.RECL 


'L' 


.BLKW 


1 


•RPCORn r VMPTH 


V. FN AM 


'L' 


.BLKW 


3 


.PTr IJ MAMTT 

/ r 1 Li£i WArlri 


V.FTYP 


: 'L' 


.BLKW 


1 


• P T r IT TVDTT 


V.FVER 


'L' 


.BLKW 


1 




V.CDAT 


: 'L' 


.BLKW 


2 


;CREATION DATE 


V. EDAT 


: 'L' 


.BLKW 


2 


;EXPRIATION DATE 


V.BLKC 


: 'L' 


.BLKW 


2 


;BLOCK COUNT FOR FILE SECTION 


V.RTYP 


: 'L' 


.BLKB 


1 


; RECORD TYPE 


V.FATT 


: 'L' 


.BLKB 


1 


;FILE ATTRIBUTES FOR CARRIAGE CONTROL 






.BLKB 


30. 


;REMAINDER OF FILE ATTRIBUTES 


; NULL 


WINDOW SECTION 




} 

V.WIND 


■L' 


.BLKW 


4. 


; NULL WINDOW 


V.MST2: 'L' 


.BLKW 


1 


; MAGTAPE STATUS BITS 


V.FABY: 'L 1 


.BLKB 


1 


;FILE ACCESSIBILITY BYTE (HDRl ) 






.BLKB 


1 


; SPARE 


V.ANSN 


• 'L' 


.BLKB 


17. 


;ANSI 17 CHARACTER FILE NAME 


V.BOFF 


• 'L' 


.BLKB 


1. 


;BUFFER OFFSET 


V.DENS 


•L' 


.BLKB 


1. 


; REQUESTED UNIT DENSITY 


V. DRAT 


: 'L' 


.BLKB 


1. 


; DEFAULT RECORD ATTRIBUTES 


V.DBLK 


: 'L' 


.BLKW 


1. 


; DEFAULT BLOCK SIZE 


V.DREC 


'L' 


.BLKW 


1. 


; DEFAULT RECORD SIZE 


S.VSCB= 


= 'B' 






;SIZE OF VSCB 
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.PSECT 

DEFINE OFFSETS INTO NULL WINDOW SECTION 
.ASECT 



.=0 

W.CTL: 'L' .BLKW 1 
V.WINC= * B * V.WIND+W.CTL 

.PSECT 



; CONTROL WORD IN WINDOW 

: CNTRL WORD IN NULL WINDOW 



.=0 



; RELATIVE TO THE VSCB 
MOUNTED VOLUME LIST OFFSET DEFINITIONS (MVL) 
.ASECT 

R$$11M 



.IF DF 

M.NXT: 'L' .BLKW 1 

. ENDC 

M.UIC: 'L* .BLKW 1 
M . CH : ' L 1 .BLKW 1 
M.PROT: 'L • .BLKW 1 



. IF 



M.NXT: "L 



NDF 

.BLKW 2 
.BLKW 1 
.ENDC 
.BLKB 1 



R$$11M 



M . RVOL :: ' L 

M.STAT:: 'L 1 .BLKB 1 

M.VIDP: 'L' .BLKW 1 

M.UCB: 'L' .BLKW 1 

S.MVL= , B' . 

.PSECT 

UNMOUNTED VOLUME AND VOLUME 
.ASECT 

.=0 

L.NXT: »L' .BLKW 1 
L.VOL1: 'L' .BLKB 1 
L.VOL2: 'L' .BLKB 1 
L.VID1: 'L' .BLKB 6 
L.VID2: 'L' .BLKB 6 
S.UVL= 'B' . 



;PTR TO NXT MVL NODE (11M) 



; OWNER UIC FROM RVOL #1 

; U.CH/U.VP (11D) 

; PROTECTION U.AR IN 11D 



; ACP WORDS 11D 

;PTR TO NEXT MVL NODE (11D) 

; RELATIVE VOL # OF MOUNTED VOLUME 

; VOLUME STATUS 

;VOLUME ID POINTER 

; ADDR OF ASSOC UCB OR PUD 

;SIZE OF MVL NODE 



LIST OFFSET DEFINITIONS (UVL) 



;PTR TO NXT UVL NODE 
; REL VOL # OF l'ST VOL IN NODE 
; REL VOL # OF 2'ND VOL IN NODE 
;VOL ID OF l'ST VOL IN NODE 
;VOL ID OF 2'ND VOL IN NODE 
;SIZE OF UVL NODE 



.PSECT 

SYSTEM DATA STRUCTURE CONTENT VALUES 



VSCB VALUES 
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; V.MOU 


VALUES 






VM.OLD 




'B' 


200 


;OLD .FL300 VOLUME — VM.BYP WILL ALSO BE 


VM.BYP 




•B ' 


100 


;BYPASS LABEL PROCESSING 


VM.ULB 




'B' 


40 


; UNLABELED TAPE 


VM.FSC 




'B ' 


20 


; OVERRIDE FILE SET ID CHECK 


VM.EXC 




'B' 


10 


;OVERRIDE EXPRIATION DATE CHECK 


; V.MST2 


VALUES 






V2. INI 




•B' 


1 


;MAG WANTS US TO INITIALIZE NEXT OUTPUT 


V2.XH2 




•B' 


2 


;THIS FILE HAS NO HDR2, DON'T WRITE EOF2 


V2.XH3 




•B' 


4 


;THIS FILE HAS NO HDR3 , DON'T WRITE EOF3 


V2.NH3 




'B' 


10 


;DON'T WRITE HDR3/EOX3 LABELS 


V2 . OAC 




'B' 


20 


;OVERRIDE FILE/VOLUME ACCESIBILITY 


; V.PSTA 


VALUES 


- UNBLOCKED TRANSITION STATE 


VP.RM 




'B' 


2 


; READ DATA MODE 


VP.WM 




•B' 


4 


; WRITE DATA MODE 


VP . UCM 




'B ' 


6 


; UNLABELLED CREATE POSITIONING MODE 


VP.SM 




•B' 


10 


; SEARCH MODE 


VP.MOU 




•B' 


20 


;MOUNT MODE 


VP . RWD 




'B' 


40 


; REWIND OR VOL VERIFICATION WAIT 


VP. VFY 




•B' 


VP . RWD 




VP.POS 




'B' 


100 


;PROCESS IN POSITIONING MODE 










; (MULTI-SECTION FILE) 


; BLOCKED 


STATE 


= -(UNBLOCKED 


TRANSITION STATE VALUES) 


; PROCESS 


TIMED 


OUT BIT 0=1 




e 


VP.TO= 1 


B'l 




i 

NULL WINDOW CONTROL BIT DEFINITIONS 


WI.RDV 




'B' 


400 


;ACCESSED FOR READ 


WI .WRV 




'B' 


1000 


;ACCESSED FOR WRITE 


WI.EXT 




'B' 


2000 


; ACCESSED FOR EXTEND 


WI.LCK 




'B' 


4000 


; LOCKED 



MVL VALUES IN THE M.STAT FIELD 



MS.VER 
MS. RID 
MS . NMO 
MS . TMO 
MS. EXP 



= 'B ' 
= 'B' 
= 'B' 
= 'B' 
= 'B ' 



200 
1 
2 
4 

10 



;VOL ID NOT VERIFIED 
;VOL ID TO BE READ NOT CHECKED 
;MOUNT MESSAGE NOT GIVEN YET 
;ONE TIMEOUT ALREADY EXPRIED 
;EXPIRATION DATE MESSAGE GIVEN 



MISC BITS USED IN MOUNT (STORED IN V.STS) 



MO . OVR 
MO.UIC 
MO . PRO 
MO. 160 



= 'B' 
= 'B' 
= 'B' 
= 'B' 



1 
2 
4 

10 



OVER RIDE VOL NAME SWITCH 
EXPLICIT UIC GIVEN 
EXPLICIT PROTECTION GIVEN 
1600 BPI SPECIFIED 



.ENDM 
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.MACRO OLRDF$ $$$GBL 



THIS MODULE DEFINES THE ONLINE RECONFIGURATION INTERFACE 
AS IMPLEMENTED BETWEEN THE RSX-11M-PLUS TASKS CON, HRC, AND 
THE RDDRV. 



DEFINE THE I/O FUNCTION CODES FOR ONLINE RECONFIGURATION CONTROL. 



. MCALL .WORD. , DEFIN$ 
.IF IDN <$$$GBL>,<DEF$G> 

. . . GBL=1 

. IFF 

. . . GBL=0 

. ENDC 



THE FOLLOWING MACRO DEFINES THE SUB-FUNCTION CODES FOR EACH OF THE 
OPERATIONS PERFORMED BY THE HRC TASK AND A PARAMETER DESCRIBING THE 
ARGUMENTS REQUIRED FOR EACH FUNCTION. IN A MACRO CALL THE FOLLOWING 
ARE THE LEGAL COMBINATIONS FOR THE 'MASK' PARAMETER: 



<> SIGNIFYING NO PARAMETERS 

<D> SIGNIFYING ONE BUFFER DESCRIPTOR 

<D,D> SIGNIFYING TWO BUFFER DESCRIPTORS 
<D,CT> SIGNIFYING ONE DESCRIPTOR AND 'CT' 

BYTES OF PARAMETERS 
<CT> SIGNIFYING 'CT' BYTES OF PARAMETERS 



.MACRO FUNC NAME , SUBF , FUN , MASK 

.WORD. 10. ' NAME , SUBF , FUN 
FUNCA NAME , <MASK> 
. ENDM 



.MACRO FUNCA NAME ,MSK 

PARCT=0 

DESCT=0 

.IRP X,<MSK> 

.IIF IDN <X>,<P> PARCT=PARCT+1 
.IIF IDN <X>,<D> DESCT=DESCT+1 

.IIF GT <PARCT-17> .ERROR INVALID PARAMETER COUNT 
.IIF GT <DESCT-17> . ERROR INVALID DESCRIPTOR COUNT 
. ENDR 

TEMP=<DESCT*4>+<PARCT*2> 

.WORD. 10$ 'NAME, < <DESCT* 20+PARCT>> , TEMP 
. ENDM 



DEFINE ONLINE RECONFIGURATION I/O FUNCTIONS 



.WORD. IO.MFC,000,001 ; MULT I -FUNCT ION MODIFY CONFIGURATION 
.WORD. IO.RSC,000,002 ; READ SYSTEM CONFIGURATION 
.WORD. IO.WSC, 000, 006 ; MODIFY DEVICE CONFIGURATION 
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DEFINE SUBFUNCTIONS TO MODIFY DEVICE CONFIGURATION 



FUNC 


ONL,001,006,<D,D> 




' SET DEVICE ONLINE 


FUNC 


OFL, 002, 006,<D,D> 




SET DEVICE OFFLINE 


FUNC 


MAI ,003,006, <D,D> 




SET DEVICE IN MAINTAINENCE MODE 


FUNC 


CAC, 004,006,0 




; CACHE CONTROL 


FUNC 


MEM, 005, 006,0 




MIND CONTROL 


FUNC 


STN,006,006,<P,P> 




; RECONFIGURATION CONTROL, 
SPECIFY TASK NAME 


FUNC 


HRC,007,006 ,<P,P> 




RECONFIGURATION CONTROL, 
HRC OPERATING MODE 


FUNC 


ONE,010,006,<P,P> 




; ON <CONDITION> <COMMAND> 


FUNC 


STA,011,006,<D> 




RETURN DEVICE STATE 


FUNC 


IF ,012,006,<P,P> 




■ IF <CONDITION> <COMMAND> 


FUNC 


RLI , 013, 006,<D,D,D, 


D> , 


LINK UNIBUS RUN 


FUNC 


RUL,014,006,<D,D,D, 


D> 


■ UNLINK UNIBUS RUN 


FUNC 


MBO,015,006,<P,P,D, 


D,D,D 


D,D,D,D> ; MEMORY BOX ONLINE 


FUNC 


RSW,016,006,<D,D,D, 


D> 


; SWITCH BUS 


FUNC 


WAT, 017, 006, <D> 




WRITE ATTRIBUTES 


FUNC 


RAT,020,006,<D,D> 




; READ ATTRIBUTES 


FUNC 


MBF,021,006,<P,P,D, 


D,D,D 


D,D,D,D> ; MEMORY BOX OFFLINE 



IO$MAX=21 ; DEFINE MAXIMUM SUBFUNCTION 



DEFI N$ IS.HRG,6. ; STOP PROCESSING CONDITION ENCOUNTERED 

; SECOND STATUS WORD IS ARGUMENT 



DEFINE A MACRO, WHICH WHEN EXPANDED WITH THE APPROPRIATE DEFINITION 
FOR .IOER. WILL DEFINE THE PRIVATE ERROR CODES USED BY HRC AND CON. 



.MACRO 


OLREM$ 


$$$VAL= 


-256. 


. IOER. 


IE$DAL, 


. IOER. 


I E$DNL , 


. IOER. 


IE$PRM, 


. IOER. 


IE$SYN, 


. IOER. 


IE$AFE, 


. IOER. 


IE$TMU, 


. IOER. 


IE$CAB, 


. IOER. 


IE$TRP, 


. IOER. 


IE$ALG, 


. IOER. 


IE$TQU, 


. IOER. 


IE$EPO, 


. IOER. 


IE$EUO, 


. IOER. 


IE$ECO, 


. IOER. 


IE$EPF, 


. IOER. 


IE$EUF, 


. IOER. 


IE$ECF, 


. IOER. 


IE$CFU, 


. IOER. 


IE$CSR, 


. IOER. 


IE$SWF, 


. IOER. 


IE$ICE, 


. IOER. 


IE$SCE, 


. IOER. 


I E$MDE , 



; DEFINE INITIAL ERROR NUMBER VALUE 
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IOER. IE$NFW,<No path to target device is available> 

,IOER. IE$CXT,<Unable to take unit with context offline. > 

,IOER. IE$IDU,<Invalid device descriptor> 

,IOER. IE$UNK, <Device is unknown in this conf igurat ion> 

IOER. IE$SZE, <HRC. . . Unable to access device to size drive> 

,IOER. IE$POB,<HRC. . . Can't take box offline. Partition overmaps box> 

IOER. IE$NLB, <HRC. . . Can't take box offline. Not last box in memory> 

,IOER. IE$OMP, <HRC. . . Can't modify partition size. Overmap exists> 

IOER. IE$POC , <HRC. . . Can't modify partition size. Occupied> 

IOER. IE$DFE , <HRC . . . Request format error. > 

IOER. IE$IDS,<HRC. . . Invalid device specification^ 

IOER. IE$UOE,<HRC. . . Unkown error from online/offline call> 
, ENDM 



CONDITION CODES FOR CONDITIONS TESTED BY 10. ONE AND 10. IF FUNCTIONS 



C0$0NL 
C0$0FL 
C0$UNK 
C0$ACC 
C0$ANY 
C0$MAI 



IF DEVICE NOW ONLINE 
IF DEVICE NOW OFFLINE 
UNKNOWN DEVICE 

ACCESSABLE (ACCESS PATH EXISTS) 
ANY ERROR CONDITION 
MAINTENANCE MODE 



CO$MAX = 6 



MAXIMUM -CODE 



CONDITION COMMAND CODES FOR 10. ONE AND 10. IF FUNCTIONS 



CD$STO = 2 
CD$GOT = 4 
CD$CON = 6 



'STOP' COMMAND 
1 GOTO 1 
'CONTINUE ' 



CD$MAX = 6 



MAXIMUM CONDITION DEFINED 



ARGUMENT DEFINITION FOR IO.HRC FUNCTION 



M$LOG = 1 
M$INIT = 2 
M$DEBG = 4 
M$EXIT = 10 



SUPRESS CONFIGURATION TRANSMISSION TO ERRLOG 
INITALIZE HRC 

SET HRC INTO DEBUG MODE. (DEVELOPMENT ONLY) 
EXIT REQUEST (FROM ABORT AST REQUEST) 



DEFINE TABLE OFFSETS AND STATUS BITS RETURNED IN RESPONSE TO 
A ' READ CONFIGURATION' QIO 



.ASECT 
.=0 

C$DTYP: .BLKB 1 ; ENTRY TYPE FIELD 



ENTRY TYPE CODES ARE AS FOLLOWS 
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ET$HDR 


= 1 




ET$END 


= 2 




£i i 9UE1V 


= 1 A 


C$DECT: 


. BLKB 


1 


C$DVER: 


. BLKB 


1 


C$DSTD: 


.BLKB 


1 


C$DMUB: 


.BLKB 


1 


C$DMCT: 


.BLKB 


1 




.EVEN 




C$DFAC: 


.BLKW 


2 


C$DIDN: 


• BLKW 


9. 


C$STD: 






; OFFSETS WITHIN THE FIXED 




.=0 




C$DTYP: 






C$DNAM: 


. BLKW 


1 


C$DPUN: 


.BLKB 


1 


C$DLUN: 


.BLKB 


1 


C$DSCT: 


.BLKB 


1 


C$DEVT: 


.BLKB 


1 


C$DSTS: 


.BLKW 


1 


; FLAG 


VALUES FOR C$DSTS 




CS$ATR= 


1 




CS$EXF= 


76 




CS$SUB= 


100 




;CS$xxx 


= 200 




CS$OFL= 


400 




CS$PDF= 


1000 




CS$POR= 


2000 




CS$MBD= 


4000 




CS$UNK= 


10000 




CS $ACC= 


20000 




CS$MTD= 


40000 




CS$DRV= 


100000 


:$DST2: 


.BLKW 


1 




CS$PUN= 


20 




CS$CRD= 


40 




CS$PRC= 


100 




CS$CTL= 


200 




CS$DCL= 


3400 



CONFIGURATION HEADER ENTRY 
END OF CONFIGURATION DATA 
MINIMUM VALUE FOR DEVICE SPECIFICATION 
ENTRY 

COUNT OF TABLE ENTRIES (CPUS+SWITCHED 
BUS RUNS+CONTROLLERS+UNITS) 
VERSION OF RECONFIGURATION TASK PROTOCAL 
SIZE OF HEADER 

MAXIMUM UNIBUS RUNS SUPPORTED 
MAXIMUM CONTROLLERS OF A GIVEN TYPE 
SUPPORTED 

FACILITES SUPPORTED IN HOST SYSTEM 
HRC VERSION AND BUILD TIMESTAMP 
SIZE OF THE TABLE HEADER 



ENTRY TYPE CODE 

TWO ASCII CHARACTER UNIT OR CONTROLLER NAME 
CONTROLLER NUMBER (0-255.) 

LOGICAL UNIT NUMBER IF THIS DEVICE IS A UNIT 
SUB-CONTROLLER NUMBER 
DEVICE TYPE CODE 
DEVICE STATUS MASK 



VARIABLE LENGTH ATTRIBUTE INFO IS APPENDED 
FIELD IN C$DSTS CONTAINING COUNT OF ADDITIONAL 
BYTES IN THIS DEVICE ENTRY 
THIS IS A SUB-CONTROLLER DEVICE 
UNUSED 

1=>DEVICE IS OFFLINE, 0=>DEVICE IS ONLINE 
DEVICE IS RESTRICTED TO PRIVILEGED DI AG FNS 
THIS IS A MULTIPORT DEVICE 
DEVICE IS A MASS BUS DEVICE 
DEVICE IS UNKNOWN 

AN ONLINE ACCESS PATH EXISTS TO THIS DEVICE 
DEVICE IS MOUNTED (DISK) OR LOGGED IN (TERM) 
A DRIVER IS LOADED FOR THIS DEVICE 

STATUS EXTENSION 

1=> THIS DEVICE SPECIFIED WITH PHYSICAL 
UNIT NUMBER 

1=> THIS IS A CONTROLLER RELATIVE DEVICE SPEC 
1=> THIS IS A PORT RELATIVE CONTROLLER SPEC 
DEVICE IS A CONTROLLER (MUST BE SIGN BIT) 
DEVICE CLASS CODE FIELD. MUST BE LOW ORDER 
BIT OF HIGH BYTE. 
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CLASS VALUES 




DC$UNI = 


• UNIT 


DC$CTL = 1 


• CONTROLLER 


DC$MKU = 2 


' MEMORY BOX UNIT 


DC$MKC = 3 


; MEMORY BOX CONTROLLER 


DC$SBU = 4 


• SWITCHED BUS UNIT 


DC$SBC = 5 


• SWITCHED BUS CONTROLLER 


DC$CPU = 6 


CPU 


;DC$XXX = 7 


• UNUSED 


• BLKW 2 


DEVICE DEPENDANT DATA 



C$SME: 



SIZE IF A MINIMUM ENTRY 



VARIABLE PORTION OF A GIVEN ENTRY 



FOR CONTROLLERS 
.=C$SME 
C$DKPO: .BLKW 1 

C$SCT: 



FOR UNIT ENTRIES 

.=C$SME 
C$DCTN: .BLKW 1 

C$DUPO: .BLKW 1 

C$SUN: 

FOR CPU-S 

.=C$SME 
C$DCPO: .BLKW 1 
C$SCP: 

FOR MEMORY BOXES 



PORT-STATUS-WORD. THIS DESCRIBES THE BUS RUN 
CPU OR SWITCHED BUS, TO WHICH THIS 
CONTROLLER IS CONNECTED. 
MIMIMUM SIZE OF A CONTROLLER ENTRY 



CONTROLLER NAME. TWO CHARACTER ASCII CODE 
OF THE CONTROLLER TO WHICH THIS UNIT IS 
ATTACHED. 

PORT -STATUS-WORD. THIS IS THE 

FIRST OF THE PSWS DESCRIBING THE CONTROLLER (S ) 
TO WHICH THIS UNIT IS CONNECTED. 
MIMIMUM SIZE OF A UNIT ENTRY 



PORT-STATUS-WORD. THIS IS THE BUS 
NUMBER FOR THIS CPU. 
MINIMUM SIZE OF A CPU ENTRY 
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=C$SME 



C$DCTN: . BLKW 1 
. BLKW 4 



; CONTROLLER NAME. 

; MAXIMUM OF 4 PORTS FOR MEMORY CONTROLLERS 



C$SMB: 



; MAXIMUM SIZE OF A MEMORY BOX ENTRY 



STATUS BIT DEFINITIONS FOR THE PORT STATUS WORD 



CP$OFL=400 


1=> PORT IS OFFLINE 


CP$XXX=1000 


• UNUSED 


CP$CUR=2000 


THIS PORT IS THE CURRENT PORT (S.KRB 




REFERENCES THIS PORT 


CP$XXX=4000 


■ UNUSED 


CP$XXX=10000 , 


UNUSED 


CP$ACC=20000 


THIS PORT HAS AN ACCESS PATH 


CP$MTD=40000 


PORT HAS CONTEXT OR SERVICES A DEVICE 




CONTEXT 


CP$XXX=100000 


UNUSED 


ATTRIBUTES CODES 





.MACRO ATT NAME,SIZ 
$$$TMP=$$$TMP+1 

DEFI N$ DA$ 1 NAME , $$$TMP !<400*SIZ> 
. ENDM 

$$$TMP=0 



ATT 


CSR, 


2 


CSR ADDRESS 


ATT 


VEC, 


2 


VECTOR ADDRESS 


ATT 


UBR , 


2 , 


UNIBUS RUN 


ATT 


TYP , 


2 , 


DEVICE TYPE, READ ONLY 


ATT 


VOL, 


12. 


MOUNTED VOLUME NAME, READ ONLY 


ATT 


ERR, 


10 


DEVICE ERROR COUNTERS, READ/WRITE 


ATT 


PRI , 


2 


DEVICE INTERRUPT PRIORITY 


ATT 


MBP, 


6 


• MEMORY BOX PARAMETER 


ATT 


STE, 


2 


• SANITY TIMER ENABLE/DISABLE 


ATT 


SAL, 


2 


ALARM ENABLE/DISABLE 


ATT 


DSN, 


2 


DEVICE SERIAL NUMBER 


ATT 


CSN, 


10 


• CPU SERIAL NUMBERS 



MEMORY BOX ATTRIBUTE BUFFER 



.ASECT 
.=0 



C$MBAS: 


.BLKW 


1 


; BASE ADDRESS OF BOX 


C$MINT: 


. BLKB 


1 


; INTERLEAVE FACTOR 




. BLKB 


1 


; FREE BYTE 


C$MSIZ : 


• BLKW 


1 


; SIZE OF BOX IN 32 WORD BLOCKS 


C$MGRN: 


.BLKW 


1 


; BOX GRANULARITY. "BYTES-PER-UNIT" 


C$MDSC: 






; SIZE OF BOX ATTRIBUTE BUFFER 
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.PSECT 



REDEFINE MACRO TO NULL 



.MACRO OLRDF$ X 
. ENDM 

.MACRO ATT X 
.ENDM 

.ENDM 



MACRO FOR THE DEFINITION OF DEVICE TYPE CODES 



,GBL=1 



.MACRO DEVCD$ $$$GBL 
. MCALL DEFIN$ 
.IF IDN <$$$GBL>,<DEF$G> 
. IFF 



, GBL = 



. ENDC 

.MACRO DEV X 
DEFIN$ D$'X,$$$TMP 
$$$TMP=$$$TMP+1 
.ENDM 

$$$TMP = 



DEV 


UDET 


; UNDETERMINED DEVICE TYPE 


DEV 


UKNO 


; UNKNOWN DEVICE TYPE 


DEV 


RK03 


; RK03 


DEV 


RK05 


; RK05 


DEV 


RK5F 


; RK05-F (DUAL DENSITY FIXED 


DEV 


RX01 


; RX01 


DEV 


RX02 


; RX02 (DUAL DENSITY RX01) 


DEV 


RL01 


; RL01 


DEV 


RL02 


; RL02 


DEV 


RP02 


; RP02 


DEV 


RP03 


; RP03 


DEV 


RP04 


; RP04 


DEV 


RP05 


; RP05 


DEV 


RP06 


; RP06 


DEV 


RP07 


; RP07 


DEV 


RK06 


; RK06 


DEV 


RK07 


; RK07 
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DEV 


RM02 


; RM02 




DEV 


RM03 


; RM03 




DEV 


RM05 


; RM05 




DEV 


RM80 


; RM80 




DEV 


RS03 


; RS03 




DEV 


RS 04 


; RS04 (DUAL 


DENSITY RS03} 


DEV 


RFll 


; RF11/RS08 




DEV 


TK25 


; TK25 




DEV 


TK50 


; TK50 




DEV 


TU10 


; TU10 




DEV 


TU16 


; TU16 




DEV 


TU45 


; TU45 




DEV 


TU77 


; TU77 




DEV 


TU78 


; TU78 




DEV 


TS11 


; TS11 




DEV 


TSUO 


; TSUO 5 




DEV 


TSVO 


; TSV05 




DEV 


TU80 


; TU80 




DEV 


TU81 


; TU81 




DEV 


TM02 


; TM02 




DEV 


TM03 


; TM03 




DEV 


TM78 


; TM78 




DEV 


TU56 


; TU56 




DEV 


TU58 


; TU58 




DEV 


TU60 


; TU60 




DEV 


MSCP 


; UDA50 




DEV 


RA60 


; RA60 




DEV 


RA80 


; RA80 




DEV 


RA81 


; RA81 




DEV 


RC25 


; RC25 (AZTEC) 


DEV 


RD50 


; RD5 




DEV 


RD51 


; RD51 




DEV 


RX50 


; RX50 




DEV 


ML11 


; ML11 




DEV 


TERM 


; TERMINAL 




$$$TMP=370 






DEV 


USRO 


; USER TYPE 





DEV 


USRl 


; USER TYPE 


1 


DEV 


USR2 


; USER TYPE 


2 


DEV 


USR3 


; USER TYPE 


3 


DEV 


USR4 


; USER TYPE 


4 


DEV 


USR5 


; USER TYPE 


5 


DEV 


USR6 


; USER TYPE 


6 


DEV 


USR7 


; USER TYPE 


7 



.MACRO DEVCD$ 
. ENDM 

.MACRO DEV X 
. ENDM 

. ENDM 
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PCBDF$ 



MAIN PARTITION PCB 



.=0 

P.LNK: 

P . NAM : 
P.SUB: 
P. MAIN 
P.REL: 
P.BLKS 
P. SIZE 
P. WAIT 

P.STAT 
P.ST2: 



.ASECT 

•L ' .BLKW 
. BLKW 
'L' .BLKW 
' L ' .BLKW 
: 'L' .BLKW 1 
1 L ' . BLKW 1 
: ' L ' 

: 'L' .BLKW 1 
: 'L' .BLKW 2 

.BLKW 2 
: * L ' .BLKW 1 
'L' .BLKW 1 

.BLKW 3 



P.HDLN: 'L' .BLKB 1 
P. IOC: 'L' .BLKB 1 

$$$=. 

P.RRM: 'L" .BLKW 1 



; LINK TO NEXT MAIN PARTITION PCB 
; (UNUSED) 

; PARTITION NAME IN RAD 50 

; POINTER TO FIRST SUBPARTITION 

; POINTER TO SELF 

;STARTING PHYSICAL ADDRESS IN 32W BLOCKS 

;SIZE OF PARTITION IN 32W BLOCKS 
; PARTITION WAIT QUEUE LISTHEAD 
; (UNUSED) 

; PARTITION STATUS FLAGS 

;STATUS EXTENSION FOR COMMON AND MAIN PCB'S 
; (UNUSED) 

;SIZE OF EXTERNAL HEADER IN 32W BLOCKS 
; PARTITION I/O COUNT 



; REQUIRED RUN MASK 



= $$$ 



IF NDF M$$PRO 



, ENDC 



.IF NB SYSDEF 
P. LGTH = *B ' . 

.ENDC 



; PARTITION CONTROL BLOCK LENGTH 



TASK REGION PCB 



.=0 

P.LNK: 'L ' .BLKW 
P.PRI: 'L' .BLKB 
P.RMCT: ' L • .BLKB 
P.NAM: *L' .BLKW 
P.SUB: 'L ' .BLKW 
P. MAIN: ' L 1 .BLKW 
P.REL: 'L ' .BLKW 
P.BLKS: ' L ' 



;UTILITY LINK WORD 
;PRIORITY OF PARTITION 
; RESIDENT MAPPED TASKS COUNT 
; PARTITION NAME IN RAD 50 
/POINTER TO NEXT SUBPARTITION 
;POINTER TO MAIN PARTITION 

/STARTING PHYSICAL ADDRESS IN 32W BLOCKS 
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P. SIZE: 'L' . BLKW 1 

.BLKW 1 

P.SWSZ: 'L' .BLKW 1 

P.DPCB: 'L' .BLKW 1 

P.TCB: 'L ' .BLKW 1 

P.STAT: 'L' .BLKW 1 

P.HDR: 'L' .BLKW 1 

.BLKW 1 

P. ATT: 'L' .BLKW 2 



SIZE OF PARTITION IN 32W BLOCKS 
(UNUSED) 

PARTITION SWAP SIZE 

CHECKPOINT ALLOCATION PCB 

TCB ADDRESS OF OWNER TASK 

PARTITION STATUS FLAGS 

POINTER TO HEADER CONTROL BLOCK 

(UNUSED) 

ATTACHMENT DESCRIPTOR LISTHEAD 



P. HDLN: 'L ' .BLKB 1 
P. IOC: 'L' .BLKB 1 

$$$=. 



;SIZE OF EXTERNAL HEADER IN 32W BLOCKS 
; PARTITION I/O COUNT 



P.RRM: 'L' .BLKW 



;REQUIRED RUN MASK 



.IF NDF M$$PRO 

.=$$$ 

. ENDC 



; + 

; COMMON REGION PCB 
.=0 



P.LNK: 1 


L' 


• BLKW 


1 


UTILITY LINK WORD 


P. PRI : ' 


L 1 


.BLKB 


1 


PRIORITY OF PARTITION 


P.RMCT: 


•L 


' .BLKB 


1 


RESIDENT MAPPED TASKS COUNT 


P . NAM : • 


L' 


.BLKW 


2 


•PARTITION NAME IN RAD 5 


P. SUB: ' 


L' 


.BLKW 


1 


POINTER TO NEXT SUBPARTITION 


P. MAIN: 


'L 


' .BLKW 


1 


POINTER TO MAIN PARTITION 


P.REL: ' 


L' 


• BLKW 


1 


STARTING PHYSICAL ADDRESS IN 32W BLOCKS 


P.BLKS: 


'L 


■ 






P. SIZE: 


'L 


' .BLKW 


1 


SIZE OF PARTITION IN 32W BLOCKS 


P.CBDL: 


'L 


1 .BLKW 


1 


^COMMON BLOCK DIRECTORY LINK 


P.CSBA: 


'L 


i 




CACHE STATISTICS BLOCK LISTHEAD 










• ...(IF P2.CHE IS SET, PARTITION WON'T SWA 


P.SWSZ: 


•L 


' .BLKW 


1 


PARTITION SWAP SIZE 


P.DPCB: 


'L 


' .BLKW 


1 


POINTER TO DISK PCB 


P. OWN: ' 


L' 


.BLKW 


1 


OWNING UIC OF REGION 


P.STAT: 


'L 


1 .BLKW 


1 


PARTITION STATUS FLAGS 


P.ST2: ' 


L' 


.BLKW 


1 


STATUS EXTENSION FOR COMMON AND MAIN PCB 1 S 


P. PRO: 1 


L ' 


.BLKW 


1 


PROTECTION WORD [DEWR , DEWR , DEWR , DEWR ] 


P . ATT : • 


L' 


.BLKW 


2 


•ATTACHMENT DESCRIPTOR LISTHEAD 


P. HDLN: 


'L 


* .BLKB 


1 ;SIZE OF EXTERNAL HEADER IN 32W BLOCKS 


P. IOC: 1 


L' 


.BLKB 


1 ; PARTITION I/O COUNT 


$$$=. 











P.RRM: 'L' .BLKW 



;REQUIRED RUN MASK 
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.IF NDF M$$PRO 

.=$$$ 



. ENDC 



.PSECT 



+ 

PARTITION STATUS WORD BIT DEFINITIONS 



PS.OUT = 
PS.CKP = 
PS.CKR= 
PS.CHK= 
PS . FXD : 
PS.CAF' 
PS .LIO= 
PS.NSF = 
PS.COM: 
PS.LFR= 
PS.PER= 
PS . NWB : 
PS .DEL = 



'B'lOOOOO 

'B '40000 

■B '20000 

'B'10000 

'B '4000 

'B'2000 

'B'lOOO 

'B'400 

'B'200 

'B'100 

'B'40 

'B'20 

'B'10 



PS . AST= 'B ' 4 



PARTITION IS OUT OF MEMORY (1=YES) 
PARTITION CHECKPOINT IN PROGRESS (1=YES) 
PARTITION CHECKPOINT IS REQUESTED (1=YES) 
PARTITION IS NOT CHECKPOINTABLE (1=YES) 
PARTITION IS FIXED (1=YES) 

CHECKPOINT SPACE ALLOCATION FAILURE (1=YES) 
MARKED BY SHUFFLER FOR LONG I/O (1=YES) 
PARTITION IS NOT SHUFFLEABLE (1=YES) 
LIBRARY OR COMMON BLOCK (1=YES) 
LAST LOAD OF REGION FAILED (1=YES) 
PARTI Y ERROR OCCURED IN THIS REGION (1=YES) 
COMMON SHOULDN'T BE WRITTEN BACK 
PARTITION SHOULD BE DELETED WHEN NOT ATTACHED 
(1=YES) 

PARTITION HAS REGION LOAD AST PENDING 



+ 

REQUIRED RUN MASK 



PR.UBT= 


B 


100000 


UNIBUS 


RUN T 


PR.UBS= 


•B 


40000 


'UNIBUS 


RUN S 


PR.UBR= 


B 


20000 


UNIBUS 


RUN R 


PR.UBP= 


•B 


10000 


fUNIBUS 


RUN P 


PR.UBN= 


B 


4000 


'UNIBUS 


RUN N 


PR.UBM= 


' B 


2000 


UNIBUS 


RUN M 


PR.UBL= 


B 


1000 


UNIBUS 


RUN L 


PR.UBK= 


'B 


400 


•UNIBUS 


RUN K 


PR.UBJ= 


'B 


200 


UNIBUS 


RUN J 


PR.UBH= 


'B 


100 


■UNIBUS 


RUN H 


PR.UBF= 


B 


40 


•UNIBUS 


RUN F 


PR.UBE= 


•B 


20 


;UNIBUS 


RUN E 


PR.CPD= 


B 


10 


PROCESSOR D 


PR.CPC= 


B 


4 


PROCESSOR C 


PR.CPB= 


B 


2 


PROCESSOR B 


PR.CPA= 


B 


1 


PROCESSOR A 



+ 

STATUS EXTENSION WORD BIT DEFINITIONS 

(THESE BITS CAN ONLY BE EXAMINED IN COMMON OR MAIN PCB ' S ) 
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P2.LMA= 


•B 


'40000 


P2.CPC= 


•B 


20000 


P2.CHE= 


'B 


10000 


P2.SEC= 


'B 


'4000 


P2.PAR= 


'B 


2000 


P2.POL= 


B 


1000 


P2.CPU= 


'B 


400 


P2. PIC= 


'B 


200 


P2.RON= 


'B 


100 


P2.DRV= 


B 


40 


P2.APR= 


'B 


7 



DON'T SHUFFLE, DELETE SPINDLE OR MUTILATE 
THIS PARTITION 

CPCR INITIATED CHECKPOINT PENDING 
CACHE PARTITION 

THIS IS RO SECTION OF MU TASK 
WITH TCB IN SEC. POOL 

THE FIXER TASK HAS HANDLED A PARITY ERROR 
SECONDARY POOL PARTITION 
MULTIPROCESSOR CPU PARTITION 

POSITION INDEPENDENT LIBRARY OR COMMON (1=YES) 

READ-ONLY COMMON (1=YES) 

DRIVER COMMON PARTITION (1=YES) 

STARTING APR NUMBER MASK FOR NON-PIC COMMON 



CHECKPOINT FILE PCB 



.ASECT 

.=0 

P.LNK: 'L 1 
P.UCB: 'L' 
P. LBN: 'L' 



• BLKW 
. BLKW 
.BLKW 
.BLKW 
.BLKW 



P. SUB: 'L' 
P. MAIN: 'L' .BLKW 1 
P.REL: 'L' .BLKW 1 
P. SIZE: 'L' .BLKW 1 
P . DLGH= 1 B ' . 



; LINK WORD OF CHECKPOINT FILE PCB ' S 
;UCB ADDRESS OF CHECKPOINT FILE DEVICE 
; H IGH PART OF STARTING LBN 
;LOW PART OF STARTING LBN 

; POINTER TO FIRST CHECKPOINT ALLOCATION PCB 
;MUST BE (FOR $RLPR1) 

;CONTAINS IF FILE IN USE, 1 IF NOT IN USE 
;SIZE OF CHECKPOINT FILE IN 256W BLOCKS 
; LENGTH OF ALL DISK PCB'S 



CHECKPOINT ALLOCATION PCB 



.=0 

.BLKW 4 
P. SUB: 'L' .BLKW 1 
P. MAIN: * L 1 .BLKW 1 
P.REL: "L" .BLKW 1 
P. SIZE: 'L' .BLKW 1 



; (UNUSED) 

; LINK TO NEXT CHECKPOINT ALLOCATION PCB 
; ADDRESS OF CHECKPOINT FILE PCB 
; RELATIVE POSITION IN FILE IN 256W BLOCKS 
;SIZE ALLOCATED IN 256W BLOCKS 



COMMON TASK IMAGE FILE PCB 



.=0 

P.FID1: 'L' .BLKW 1 
P.UCB: 'L 1 .BLKW 1 
P. LBN: 'L' .BLKW 1 

.BLKW 1 
P.FID2: 'L' .BLKW 1 
P. MAIN: 'L' .BLKW 1 
P.REL: 'L • .BLKW 1 
P.FID3: 'L' .BLKW 1 



;FILE ID WORD FOR SAVE 

;UCB ADDRESS OF DEVICE ON WHICH COMMON RESIDES 

; H IGH PART OF STARTING LBN 

;LOW PART OF STARTING LBN 

;FILE ID WORD FOR SAVE 

; POINTER TO SELF 

; ALWAYS CONTAINS A 

; FILE ID WORD FOR SAVE 



ATTACHMENT DESCRIPTOR OFFSETS 
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. ASECT 

= 



A.PCBL: 


•L 


1 . BLKW 


1 


;PCB ATTACHMENT QUEUE THREAD WORD 


A.PRI: ' 


L' 


. BLKB 


1 


; PRIORITY OF ATTACHED TASK 


A. IOC: ' 


L' 


.BLKB 


1 


;I/0 COUNT THROUGH THIS DESCRIPTOR 


A.TCB: ' 


L' 


.BLKW 


1 


;TCB ADDRESS OF ATTACHED TASK 


A.TCBL: 


'L 


' .BLKW 


1 


;TCB ATTACHMENT QUEUE THREAD WORD 


A.STAT: 


'L 


' .BLKB 


1 


; STATUS BYTE 


A.MPCT: 


'L 


' .BLKB 


1 


/MAPPING COUNT OF TASK THRU THIS DESCRIPTOR 


A.PCB: ' 


L' 


.BLKW 


1 


;PCB ADDRESS OF ATTACHED TASK 


A. LGTH= 


•B 


i 




; LENGTH OF ATTACHMENT DESCRIPTOR 



+ 

ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS 



.PSECT 

AS.PRO='B'100 ;A.TCB IS SEC POOL TCB BIAS (1=YES) 

AS.SBP='B'20 ;CACHE BYPASS REQUESTED 

AS.RBP= , B , 40 ; REQUEST TO NOT BYPASS CACHE 

AS.DEL='B'10 ; TASK HAS DELETE ACCESS (1=YES) 

AS.EXT='B'4 ; TASK HAS EXTEND ACCESS (1=YES) 

AS.WRT='B'2 ; TASK HAS WRITE ACCESS (1=YES) 

AS.RED='B , 1 ; TASK HAS READ ACCESS (1=YES) 

.MACRO PCBDF$ X,Y,Z 

.ENDM 

. ENDM 
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PKTDF$ 



.MACRO PKTDF$,L,B 



ASYNCHRONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS 

SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL BLOCK 
ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 



.ASECT 

.=177774 

A.KSR5: 'L ' . BLKW 1 
A.DQSR: 'L' . BLKW 1 

.BLKW 1 
A.CBL: 'L' .BLKW 1 



A. BYT: 'L' .BLKW 
A. AST: 'L • .BLKW 
A.NPR: 'L' .BLKW 
A.PRM:'L' .BLKW 
AS .FPA= 'B 1 1 
AS .RCA= 'B 1 2 
AS . RRA= ' B 1 3 
PEA='B'4 
REA= 'B ' 5 
PFA='B '6 



AS 
AS 
AS 



AS.CAA='B'7 



SUBROUTINE KISAR5 BIAS (A.CBL=0) 

DEQUEUE SUBROUTINE ADDRESS (A.CBL=0) 

AST QUEUE THREAD WORD 

LENGTH OF CONTROL BLOCK IN BYTES 

IF A.CBL = 0, THE AST CONTROL BLOCK IS 

TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE 

POINTED TO BY A.DQSR MAPPED VIA APR 5 

VALUE A.KSR5. THIS IS CURRENTLY USED ONLY 

BY THE FULL DUPLEX TERMINAL DRIVER FOR 

UNSOLICITED CHARACTER ASTS . 

IF THE LOW BYTE OF A.CBL = 0, AND THE 

HIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK 

IS A SPECIFIED AST, WITH LENGTH, C.LGTH. 

IF THE HIGH BYTE OF A.CBL=0 

AND THE LOW BYTE > 0, THEN 

THE LOW BYTE IS THE LENGTH OF THE 

AST CONTROL BLOCK. 

IF HIGH BYTE = AND LOW BYTE IS NEGATIVE, 

THEN THE BLOCK IS A KERNEL AST 

BIT 6 IS SET IF $SGFIN SHOULD 

NOT BE CALLED PRIOR TO DISPATCHING 

THE AST, AND THE LOW SIX BITS (5-0) 

REPRESENT THE INDEX/2 INTO THE 

KERNEL AST DISPATCH TABLE ($KATBL ) 

NUMBER OF BYTES TO ALLOCATE ON TASK STACK 

AST TRAP ADDRESS 

NUMBER OF AST PARAMETERS 

FIRST AST PARAMETER 

CODE FOR FLOATING POINT AST 

CODE FOR RECEIVE DATA AST 

CODE FOR RECEIVE BY REFERENCE AST 

CODE FOR PARITY ERROR AST 

CODE FOR REQUESTED EXIT AST 

CODE FOR POWER FAIL AST 

CODE FOR CLI COMMAND ARRIVAL AST 



BIT VALUES IN A.PRM+5 



AF.XCC='B'l 
AF.NOT='B'2 
AF . OOB= 'B ' 4 
AF.AST= 'B ' 10 
AF.ESQ='B'20 
AF.LCK= 'B • 40 
AF.QUE='B I 100 
AF ,MDE= 'B ' 200 



; ATTACHED FOR ALL BUT CONTROL-C (TF.XCC) 
; ATTACHED FOR ALL NOTIFICATION (TF.NOT) 
;ACB IS FOR OUT-OF-BAND AST 

;ACB HANDLES UNSOL. INPUT CHAR AST'S (TF.AST) 

; ATTACHED FOR ESCAPE SEQUENCES (TF.ESQ) 

;ACB IS LOCKED 

;ACB IS QUEUED 

;ACB IS MARKED FOR DELETE 
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ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S STACK 



AB . NPV== ' B 1 1 
AB.TYP='B'2 

A.PLGH=--'B'70 
A.DUCB='B'10 
A.DLGH== 'B ' 10. 



; ABORTER IS NON PRIVILEGED (1=YES) 

; ABORT FROM DIRECTIVE (0=YES) 

; ABORT FROM CLI COMMAND (1=YES) 

;SIZE OF PARITY ERROR AST CONTROL BLOCK 

;UCB OF TERM ISSUING DEBUG COMMAND 

; LENGTH OF DEBUG (AK.TBT) AST BLOCK 



KERNEL AST CONTROL CODES (A.CBLi 



AK.BUF== 'B' 200 



AK.OCB-^'B^Ol 
AK.GBI=='B '202 
AK.TBT=='B'203 
AK.DIO=='B , 204 
AK.GGF='B'205 
+ 



/BUFFERED I/O COMPLETION 

;THIS CODE MUST BE 200 UNTIL ALL 

; REFERENCES IN TTDRV ARE FIXED 

; OFFSPRING TASK EXIT 

; SEGMENTED BUFFERED I/O COMPLETION 

; TASK FORCE T-BIT TRAP (DEBUG CMD) 

/DELAYED I/O COMPLETION 

/GRP. GBL . RUNDWN 



BIT DEFINITIONS FOR THE GET/SET INFORMATION DIRECTIVE. 



SF.PRV^'B'100000 
SF.IN='B' 40000 



/FUNCTION IS PRIVILEGED 
/FUNCTION IS AN INPUT FUNCTION 



GROUP GLOBAL EVENT FLAG BLOCK OFFSETS 



.=0 

G.LNK: 'L' .BLKW 1 

G.GRP: 'L' . BLKB 1 

G.STAT: 'L' .BLKB 1 

G.CNT: 'L' .BLKW 1 

G. EFLG: 'L 1 .BLKW 2 

G.LGTH='B' . 



GS.DEL='B'l 



/LINK WORD 
/GROUP NUMBER 
/STATUS BYTE 
/ACCESS COUNT 
/EVENT FLAGS 

/LENGTH OF GROUP GLOBAL EVENT FLAG 
/BLOCK 

/STATUS BIT — MARKED FOR DELETE 



/ EXECUTIVE POOL MONITOR CONTROL FLAGS 

/ $POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR 



PC.HIH='B'l 
PC.LOW= , B , 2 
PC.ALF='B'4 
PC.XIT^B'200 



PC.NRM='B' PC.HIHM00 
PC . ALM= • B ' PC . LOW* 4 00 



HIGH POOL LIMIT CROSSED (1=YES) 

LOW POOL LIMIT CROSSED (1=YES) 

POOL ALLOCATION FAILURE (1=YES) 

FORCE POOL MONITOR TASK TO EXIT (MUST 

BE COUPLED WITH SETTING FE.MXT IN THE 

FEATURE MASK) 

POOL TASK INHIBIT BIT FOR HIGH POOL 
POOL TASK INHIBIT BIT FOR LOW POOL 
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$POLFL IS THE POOL USAGE CONTROL WORD 



PF.INS='B , 40 

PF.LOG^B'IOO 

PF.REQ= , B , 200 

PF.ALL='B'177777 

+ 



; REJECT NONPRIVILEGED INS/RUN/REM 
; NONPRIVILEGED LOGINS ARE DISABLED 
; STALL REQUEST OF NONPRIV. TASKS 

; TAKE ALL POSSIBLE ACTIONS TO SAVE POOL 



OFFSPRING CONTROL BLOCK DEFINITIONS 

SOME POSITIONAL DEPENDENCIES ARE DEPENDED ON BETWEEN THE OCB AND THE 
AST BLOCK IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 



.=0 

. LNK : ' L ' .BLKW 1 
O.MCRL: 'L' .BLKW 1 
O.PTCB: 'L' .BLKW 1 
0. AST: 'L' .BLKW 1 
O.EFN: 'L' .BLKW 1 
O.ESB: 'L' .BLKW 1 
O.STAT: 'L 1 .BLKW 8. 
. LGTH= 'B ' . 



OCB LINK WORD 

ADDRESS OF MCR COMMAND LINE 
PARENT TCB ADDRESS 
EXIT AST ADDRESS 
EXIT EVENT FLAG 

EXIT STATUS BLOCK VIRTUAL ADDRESS 
EXIT STATUS BUFFER 
LENGTH OF OCB 



I/O PACKET OFFSET DEFINITIONS 



ASECT 



.=0 








I .LNK: 


•L' 


.BLKW 


1 


I .PRI : 


'L' 


.BLKB 


1 


I . EFN : 


'L' 


.BLKB 


1 


I . TCB : 


'L' 


.BLKW 


1 


I . LN2 : 


'L' 


.BLKW 


1 


I.UCB: 


•L' 


.BLKW 


1 


I.FCN: 


•L' 


.BLKW 


1 


I . IOSB 


: 'L' 


.BLKW 






.BLKW 


1 






.BLKW 


1 


LAST: 


•L' 


.BLKW 


1 


I . PRM: 


'L' 


.BLKW 


1 






.BLKW 


6 






.BLKW 


1 



I/O QUEUE THREAD WORD 

REQUEST PRIORITY 

EVENT FLAG NUMBER 

TCB ADDRESS OF REQUESTOR 

POINTER TO SECOND LUN WORD 

POINTER TO UNIT CONTROL BLOCK 

I/O FUNCTION CODE 

VIRTUAL ADDRESS OF I/O STATUS BLOCK 
I/O STATUS BLOCK RELOCATON BIAS 
I/O STATUS BLOCK ADDRESS 
AST SERVICE ROUTINE ADDRESS 
RESERVED FOR MAPPING PARAMETER #1 
PARAMETERS 1 TO 6 

USER MODE DIAGNOSTIC PARAMETER WORD 



FOLLOWING ARE DEFINITIONS FOR FLAG BITS 
(DSA DRIVERS INTERNAL USE ONLY) 



IN I.PRM+11 



IP.FAK ='B' 20 
IP. ABO ='B' 40 
IP.PND ='B' 100 
IP.UMR ='B'200 



;IOP IS PSEUDO IOP 

; (MUDRV) ABORT COMMAND MUST BE ISSUED FOR IOP 
; (MUDRV) ABORT COMMAND WAS ISSUED FOR IOP 
;A UMR WAIT BLOCK IS IN USE FOR THIS I/O 
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I . ATTL= 'B ' . 



I . AADA: 'L» . BLKW 2 
I . LGTH= 'B ' . 
I.ATRL= , B , 6*8. 



;MINIMUM LENGTH OF I/O PACKET (USED BY 
; FILE SYSTEM TO CALCULATE MAXIMUM 
;NUMBER OF ATTRIBUTES) 

; STORAGE FOR ATT DESCR PTRS WITH I/O 
; LENGTH OF I/O REQUEST CONTROL BLOCK 
; LENGTH OF FILE SYSTEM ATTRIBUTE BLOCK 



DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX) 

.ASECT 




I . XLNK : »L' 
I.XIOP: "L' 
I . XTCB : * L 1 
I . XMOD : ' L ' 

I.XRBF: 'L' 

I . XRBL : ' L ' 
I.XTMO: 'L' 
I.XPBF: 'L 1 

I.XPBL: 'L' 
I.XPBV: 'L' 
I.XTTB: 'L' 

I.XTTL: 'L' 
I . XDBF : ' L ' 



.BLKW 
.BLKW 
.BLKW 
.BLKW 

.BLKW 

.BLKW 
.BLKW 
.BLKW 

.BLKW 
.BLKW 
.BLKW 

.BLKW 
.BLKW 



I . XDBL : ' L ' .BLKW 



LINK WORD 

I/O PACKET ADDRESS 

TCB ADDRESS OF REQUESTING TASK 

MODIFIER WORDS (NOTE: 2ND WORD MUST BE 

SPECIFIED AND MUST BE ZERO.) 

READ DATA BUFFER ADDRESS APR BIAS 

READ DATA BUFFER VIRTUAL ADDRESS 

READ DATA BUFFER LENGTH 

READ TIME-OUT INTERVAL 

PROMPT BUFFER ADDRESS APR BIAS 

PROMPT BUFFER VIRTUAL ADDRESS 

PROMPT BUFFER LENGTH 

PROMPT BUFFER VERTICAL FORMS CONTROL 
TERMINATOR TABLE ADDRESS APR BIAS 
TERMINATOR TABLE VIRTUAL ADDRESS 
TERMINATOR TABLE LENGTH 

DEFAULT INPUT BUFFER ADDRESS APR BIAS 
DEFAULT INPUT BUFFER VIRTUAL ADDRESS 
DEFAULT INPUT BUFFER LENGTH 



CLI PARSER BLOCK (CPB) DEFINITIONS 



= 



C . PTCB : ' L 1 
C. PNAM: 'L 1 
C.PSTS: 'L' 
C.PDPL: 'L' 
C.PCPL: 'L' 
C.PRMT: 'L' 



.BLKW 
.BLKW 
.BLKW 
. BLKB 
.BLKB 



; ADDRESS OF CLI'S TCB 

;CLI NAME 

; STATUS MASK 

; LENGTH OF DEFAULT PROMPT 

; LENGTH CNTRL/C PROMPT 

; START OF PROMPT STRINGS. DEFAULT 

;IS CONCATENATED WITH CONTROL C PROMPT 



STATUS BIT DEFINITIONS 



CP.NUL='B' 1 

CP.MSG=='B'2 

CP.LGO^'B'4 

CP.DSB^'B'IO 

CP.PRV^'B^O 

CP.SGL^-'BMO 

CP.NIO=='B'100 



;PASS EMPTY COMMANDS TO CLI 

;CLI DESIRES SYSTEM MESSAGES 

;CLI WANTS COMMANDS FROM LOGGED OFF TTYS 

;CLI IS DISABLED 

;USER MUST BE PRIV TO SET TTY TO THIS CLI 
;DON'T HANDLE CONTINUATIONS (M-PLUS ONLY) 
;MCR..., HEL, BYE DO NO I/O TO TTY 
; HEL , BYE DO NOT SET CLI ETC. 
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CP.RST= 'B 1 200 ; ABILITY TO SET TO THIS CLI IS RESTRICTED 

;TO THE CLI ITSELF 

CP.EXT='B'400 ;PASS TASK EXIT PROMPT REQUESTS TO CLI 

CP.POL='B , 1000 ;CLI TCB IS IN SECONDARY POOL 

CP.CTC= 'B 1 2000 ;~C NOTIFICATION PACKETS ARE WANTED 

+ 

SECONDARY POOL COMMAND BUFFER BLOCKS 



.=0 

C.CLK: 'L 1 
C.CTCB: 
C.CUCB 
C.CCT: 
C.CSTS: 
C.CMCD: 
C.CSO: 'L' 
C.CTR: 'L 1 
C.CBLK: 'L' 
C.CTXT: 'L' 



•L' 

'L' 

L f 

•L' 

'L' 



.BLKW 
. BLKW 
.BLKW 
.BLKW 
.BLKW 

.BLKW 
. BLKB 
.BLKB 



LINK WORD 

TCB ADDRESS OF TASK TO RECEIVE COMMAND 
UCB ADDRESS OF RESPONSIBLE TERMINAL 
CHARACTER COUNT, EXCLUDING TRAILING CR 
STATUS MASK 
SYSTEM MESSAGE CODE 

STARTING OFFSET OF VALID COMMAND TEXT 
TERMINATOR CHARACTER 

SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS 
COMMAND TEXT, FOLLOWED BY CR 



+ 

STATUS BITS FOR COMMAND BLOCKS 



cc 


.MCR= 


'B 


1 


; FORCE COMMAND TO MCR 


cc 


. PRM = 


'B 


2 


; ISSUE DEFAULT PROMPT 


cc 


,EXT = 


'B 


4 


; TASK EXIT PROMPT REQUEST 


cc 


. KIL = 


*B 


10 


; DELETE ALL CONTINUATION PIECES FROM THIS 


cc 


.CLI = 


'B 


20 


; COMMAND TO BE RETREIVED BY GCCI$ ONLY 


cc 


.MSG = 


'B 


40 


; PACKET CONTAINS SYSTEM MESSAGE TO CLI 


cc 


. TTD= 


■B 


100 


; COMMAND CAME FROM TTDRV 


cc 


.CTC = 


•B 


200 


;~C NOTIFICATION PACKET 



IDENTIFIER CODES FOR SYSTEM TO CLI MESSAGES 



; CODES 





-127 


. ARE RESERVED FOR USE BY DIGITAL 


; CODES 


128.- 


255. ARE RESERVED FOR USE BY CUSTOMERS 


CM. INE= 


'B 


•1 


;CLI INITIALIZED ENABLED 


CM. IND= 


•B 


'2 


;CLI INITIALIZED DISABLED 


CM.CEN= 


•B 


'3 


;CLI ENABLED 


CM. CDS = 


'B 


'4 


;CLI DISABLED 


CM . ELM= 


'B 


'5 


;CLI BEING ELIMINATED 


CM.EXT= 


•B 


'6 


;CLI MUST EXIT IMMEDIATELY 


CM . LKT= 


B 


'7 


;NEW TERMINAL LINKED TO CLI 


CM . RMT= 


■B 


'8. 


; TERMINAL REMOVED FROM CLI 


CM.MSG= 


B 


'9. 


; GENERAL MESSAGE TO CLI 



+ 

ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS 



.=0 

A.REL: 'L 1 
A.DIS: 'L' 
A.MAS: 'L' 
A.NUM: 'L 1 



.BLKW 
.BLKW 
.BLKW 
• BLKB 



A.FLEN: 'L ' .BLKB 1 



;ACD RELOCATION BIAS 
;ACD DISPATCH TABLE POINTER 
;ACD FUNCTION MASK WORDS 
;ACD IDENTIFICATION NUMBER 
; LENGTH IN BYTES OF FULL ACB 
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A.LIN: 'L' . BLKW 1 

A.ACC: 'L ' .BLKB 1 

A.STA: 'L' .BLKB 1 
A.PLEN= , B I . 



L' 
L ' 
L 1 



.=A.LIN 
A.IMAP: 
A. IBUF: 
A. ILEN: 
A.SMAP: 1 L 1 
A.SBUF: ' L * 
A.SLEN: 1 L * 
A. IOS: 'L' 
A.RES= I B' . 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 2 



;ACD LINK WORD 
;ACD ACCESS COUNT 
;ACD STATUS BYTE 

; LENGTH IN BYTES OF PROTOTYPE ACB 

;FULL ACB OVERLAPS PROTOTYPE ACB 

;ACD INTERRUPT BUFFER RELOCATION BIAS 

;ACD INTERRUPT BUFFER ADDRESS 

;ACD INTERRUPT BUFFER LENGTH 

;ACD SYSTEM STATE BUFFER RELOCATION BIAS 

;ACD SYSTEM STATE BUFFER ADDRESS 

;ACD SYSTEM STATE BUFFER LENGTH 

;ACD I/O STATUS 

; START OF ACB RESERVED FOR USE BY THE ACD 



DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG 



UA.ACC= 


= 'B 


'1 




UA.PRO= 


= 'B 


•2 




UA.ECH= 


= 'B 


'4 




UA.TYP= 


= 'B 


■10 




UA.SPE= 


= 'B 


•20 




UA. PUT= 


:'B 


•40 




UA.CAL= 


= 'B 


'100 




UA.COM= 


= 'B 


' 200 




UA. ALL= 


= 'B 


•400 




UA . TRN= 


= 'B 


' 1000 




UA.TRA= 


= 'B 


'2000 




; DEFINE THE ACD 


ENTRY 


.=0 








A.ACCE 


'L 


' .BLKW 


1 


A.DEQU 


' 'L 


1 .BLKW 


1 


A . POWE 


«L 


' .BLKW 


1 


A. INPU 


'L 


' .BLKW 


1 


A.OUTP 


: 'L 


1 .BLKW 


1 


A. CONN 


'L 


' .BLKW 


1 


A. DISC 


■L 


' .BLKW 


1 


A.RECE 


'L 


' .BLKW 


1 


A.PROC 


•L 


' .BLKW 


1 


A.TRAN' 


' L 


' .BLKW 


1 


A. CALL 


'L 


1 .BLKW 


1 



;ACCEPT THIS CHARACTER 
; PROCESS THIS CHARACTER 
;ECHO THIS CHARACTER 

;FORCE THIS CHARACTER INTO TYPEAHEAD 
;THIS CHARACTER HAS A SPECIAL ECHO 
;PUT THIS CHARACTER IN THE INPUT BUFFER 
;CALL THE ACD BACK AFTER THE TRANSFER 
;COMPLETE THE INPUT REQUEST 

;ALLOW PROCESSING OF THIS I/O REQUEST 
; TRANSLATE CHARACTERS FROM OUTPUT QIO 
; TRANSFER CHARACTERS WHEN I/O COMPLETES 



I/O REQUEST ACCEPTANCE ENTRY POINT 

I/O REQUEST DEQUEUE ENTRY POINT 

POWER FAILURE ENTRY POINT 

INPUT COMPLETION ENTRY POINT 

OUTPUT COMPLETION ENTRY POINT 

CONNECTION ENTRY POINT 

DISCONNECTION ENTRY POINT 

INPUT CHARACTER RECEPTION ENTRY POINT 

INPUT CHARACTER PROCESSING ENTRY POINT 

OUTPUT QIO CHARACTER TRANSLATION ENTRY POINT 

CALL ACD BACK AFTER TRANSFER ENTRY POINT 



DEFINE THE STATUS BITS IN A.STA OF THE PROTOTYPE ACB 



AS.DLT='B'l 
AS.DIS='B'2 

.PSECT 



;ACD IS MARKED FOR DELETE 
;ACD IS DISABLED 



.MACRO 
. ENDM 
. ENDM 



PKTDF$ X,Y,Z 
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. MACRO SCBDF$,L,B 



STATUS CONTROL BLOCK 

THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE CONTROLLER. 
THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM. THE SCB IS POINTED TO 
BY UNIT CONTROL BLOCKS. TO EXPAND ON THE TELETYPE EXAMPLE ABOVE, EACH TELE- 
TYPE INTERFACED VIA A DL11-A WOULD HAVE A SCB SINCE EACH DL11-A IS AN IN- 
DEPENDENT INTERFACE UNIT. THE TELETYPES INTERFACED VIA THE DHll WOULD ALSO 
EACH HAVE AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT MULTIPLEXES MANY 
UNITS IN PARALLEL. 



.IF NB SYSDEF 
.ASECT 

.=0 

S.LHD:'L' .BLKW 2 CONTROLLER I/O QUEUE LISTHEAD 

S.URM:'L' ; REFERENCE LABEL 



.IF DF M$$PRO 

.BLKW 1 ;UNIBUS RUN MASK FOR THE FORK BLOCK 

. ENDC 



S.FRK: 'L' .BLKW 1 

.BLKW 1 

.BLKW 1 

.BLKW 1 



; FORK BLOCK LINK WORD 

;FORK-PC 

;FORK-R5 

;FORK-R4 



.IF DF L$$DRV 
S.KS5:'L' .BLKW 1 ; FORK KISAR5 

.ENDC 



S.PKT: 'L* 
S.CTM: 'L' 
S. ITM: 'L ' 
S.STS: 'L' 
S.ST3: 'L' 
S.ST2: 'L' 
S . KRB : ' L 1 
S.RCNT: 'L 
S.ROFF: ! L 
S.EMB: 'L 1 
S.KTB: 'L' 



.BLKW 
. BLKB 
• BLKB 
.BLKB 
.BLKB 
.BLKW 
.BLKW 
' .BLKB 
* .BLKB 
.BLKW 
.BLKW 



ADDRESS OF CURRENT I/O PACKET 

CURRENT TIMEOUT COUNT 

INITIAL TIMEOUT COUNT 

STATUS (0=FREE , NE 0=BUSY) 

STATUS EXTENSION BYTE 

STATUS EXTENSION 

ADDRESS OF KRB 

NUMBER OF REGISTERS TO COPY 

OFFSET TO FIRST DEV REG TO COPY 

ERROR MESSAGE BLOCK POINTER 

START OF MULT I -ACCESS KRBS 



PSECT 
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OFFSETS FOR MSCP/TMSCP DRIVER DATA BASES (MUDRV, DUDRV) 



S.PORT='B'S.EMB+2 
S.PBIA='B'S.EMB+4 
S.QST='B'S.EMB+6 
S.BSYU='B'S.EMB+10 



; FIRST 3 CHAR. OF PORT NAME IN RAD 50 
;BIAS OF PORT 

; ADDRESS OF QST (MU,DU CONTR. TABLE) 
;UNIT ASSOCIATED WITH OLDEST CMD TO CONTR, 



. IFF 



STATUS CONTROL BLOCK STATUS EXTENSION BIT DEFINITIONS 



S2.EIP='B'l 
S 2 . ENB= 'B 1 2 
S2.LOG='B '4 
S2.MAD='B'10 
S2.LDS='B , 40 
S2.0PT=*B' 100 
S2.CON= , B'200 
S2.OPl='B'400 
S2.OP2='B'1000 



S2.ACT='B'2000 
S2.XHR= , B'4000 
S2.KRQ='B'10000 



EREOR IN PROGRESS (1=YES) 
ERROR LOGGING ENABLED (0=YES) 
ERROR LOGGING SUPPORTED (1=YES) 
MULTIACCESS DEVICE (1=YES) 
LOAD SHARING ENABLED (1=YES) 
SUPPORTS SEEK OPTIMIZATION (1=YES) 
SCB AND KRB ARE CONTIGUOUS (1=YES) 
THESE TWO BITS DEFINE THE OPTIMIZATION 
METHOD. 

OP2,OP1=0,0 INDICATES NEAREST CYLINDER 
OP2,OPl=0 f l INDICATES ELEVATOR 
OP2,OP1=1,0 INDICATES C-SCAN 
OP2,OPl=l,l RESERVED 

DRIVER HAS OPERATION OUTSTANDING (1=YES) 
EXTERNAL HEADER AND NEW I.LN2 SUPPORT 
SCB IS QUEUED IN CONTROLLER REQUEST QUEUE 



STATUS CONTROL BLOCK STATUS EXTENSION (S.ST3) DEFINITIONS 



S3.DRL= 


' B 


1 


S3.NRL= 


•B 


2 


S3.SIP= 


1 B 


4 


S3.ATN= 


'B 


10 


S3.SLV= 


'B 


20 


S3.SPA= 


•B 


'40 


S3.SPB= 


•B 


100 


S3.0PT= 


•B 


200 


S3.SPU= 


'B 


S3.SPAIS3.SPB 



MULTI-ACCESS DRIVE IN RELEASED STATE (1-YES) 
DRIVER SHOULDN'T RLS MULTI-ACCESS DRIVE (1=YES) 
SEEK IN PROGRESS (1=YES) 

DRIVER MUST CLEAR ATTENTION BIT (1=YES) 

DEVICE USES SLAVE UNITS (1=YES) 

PORT 'A' SPINNING UP 

PORT 'B' SPINNING UP 

SEEK OPTIMIZATION ENABLED (1=YES) 

.OR. OF PORT SPINUP BITS 



KRB ADDRESS TABLE (S.KTB) PORT OFFLINE FROM THIS SCB FLAG. 



KP . OFL= 1 B ' 1 
+ 



; KRB ADDRESS POINTS TO OFFLINE PORT (1=YES) 
MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT) 
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. ASECT 

.=0 

M.LNK: 'L' .BLKW 1 
M.UMRA: 1 L * . BLKW 1 
M.UMRN: 'L' .BLKW 1 
M.UMVL: 'L 1 .BLKW 1 
M.UMVH: 'L' .BLKB 1 
M.BFVH: 'L 1 .BLKB 1 
M.BFVL: 'L 1 .BLKW 1 
M . LGTH= 'B' . 



; LINK WORD 

; ADDRESS OF FIRST ASSIGNED UMR 

; NUMBER OF OMR'S ASSIGNED * 4 

;LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR 

;HIGH-2 BITS MAPPED IN BITS 4 AND 5 

; HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS 

;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 

; LENGTH OF MAPPING ASSIGNMENT BLOCK 



. ENDC 



.PSECT 



•MACRO SCBDF$,X,Y,Z 
. ENDM 
. ENDM 
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MACRO SHDDF$ , L ,B 



FIRST, WE MUST DEFINE THE I/O PACKET DEFINITIONS, SINCE WE 
USE THEM IN OUR DEFINITIONS. 



PKTDF$ ; DEFINE I/O PACKET DEFINITIONS 

+ 

SHADOW RECORDING LINKAGE BLOCK (UMB) 

THE UMB LINKS TOGETHER TWO UCB ' S AS A SHADOW SET. ONE IS THE 

PRIMARY UCB, THE OTHER THE SECONDARY UCB. THE EXISTANCE OF A 

UMB SIGNALS THAT SHADOW RECORDING IS ENABLED ON A PARTICULAR 
UCB. 



.ASECT 

.=0 



M. 


LNK: 


•L 1 


.BLKW 


1 


; LINKAGE OF ALL UMB 1 S IN THE SYSTEM 


M. 


LHD: 


'L' 


. BLKW 


1 


; L ISTHEAD OF ALL ML NODES FOR THIS SET 


M. 


UCBS 


: 1 L 


■ .BLKW 


2 


; PRIMARY AND SECONDARY UCB ADDRESSES 


M. 


STS: 


'L' 


.BLKW 


1 


; STATUS WORD 


M. 


LBN: 


•L' 


.BLKB 


1 


;HIGH ORDER BYTE OF FENCE 








. BLKB 


1 


; UNUSED BYTE (MAYBE STATUS?) 








.BLKW 


1 


;LOW ORDER WORD OF FENCE 



M.LGH=. 
; + 

; UMB STATUS BIT DEFINITIONS 



.PSECT 

MS.MDA'B^l ;UMB MARKED FOR DEALLOCATION (1=YES) 

MS.CHP'B , =2 ;CATCHUP IN PROGRESS (1=YES) 

; + 

; DEFINE THE OFFSETS FOR THE ML NODE, LINKED OFF OF THE UMB 
; THROUGH CELL M.LHD. THIS NODE CONTAINS THE SECONDARY I/O 
; PACKET, AND DOUBLES AS THE ERROR PACKET TO THE ERROR MESSAGE 
; TASK. 



.ASECT 



.=0 










ML. LNK: 


'L' 


.BLKW 


1 


; LINKAGE OF ALL ML NODES ON UMB 


ML.LEN: 


'L' 


.BLKB 


1 


; LENGTH OF ML NODE FOR DEALLOCATION 


ML.TYP: 


'£,' 


.BLKB 


1 


; TYPE OF ML NODE FOR ERROR TASK 


ML.DNC: 


*L' 


.BLKB 


1 


; DONE COUNT OF PACKETS 






.BLKB 


1 


; UNUSED 


ML. PRI : 


■L' 


.BLKW 


1 


; PRIMARY I/O PACKET ADDRESS 


ML.PKT: 


'L' 


.BLKB 


I . LGTH 


; SECONDARY I/O PACKET 


ML . LGH= 
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ML NODE TYPE CODES 
.PSECT 

MT.PKT'B'=1 ;ML NODE IS I/O PACKET TYPE 

+ 

I/O PACKET OFFSET DEFNS FOR USE BY SHADOW RECORDING 



I .RO 'B '=1 . PRM 
I.Rl'B , =I.PRM+2 



; STATUS STORAGE FOR RO STATUS 
; STATUS STORAGE FOR Rl STATUS 



DEFINE THE ERROR MESSAGE POINTERS THAT RESIDE IN THE I/O PACKET, 



. PSECT 



ML. FID 'B ' 
ML.FSEQ 'B 
ML.LBN'B' 
ML.CNT 'B * 
ML.TCB'B' 
ML.SRO'B 1 
ML.SRl'B ' 
ML. PRO 'B ' 
ML.PRl'B 1 



=ML. PKT+I . IOSB 
' =ML.PKT+I.IOSB+2 
=ML. PKT+I .PRM+10 
=ML.PKT+I.PRM+4 
=ML . PKT+I . TCB 
=ML. PKT+I. RO 
=ML. PKT+I .Rl 
=ML. PKT+I. PRM+14 
=ML. PKT+I .PRM+16 



FILE ID WHICH CONTAINS ERROR 

FILE SEQUENCE NUMBER OF FILE IN ERROR 

HIGH ORDER LBN OF BLOCK (S) IN ERROR 

NUMBER OF BLOCKS IN BAD XFER 

TCB OF TASK WITH BAD REQUEST 

RO OF SECONDARY I/O PACKET 

Rl OF SECONDARY I/O PACKET 

RO OF PRIMARY I/O PACKET 

Rl OF PRIMARY I/O PACKET 



.MACRO SHDDF$,X,Y,Z 
. ENDM 
. ENDM 
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.MACRO TCBDF$,L,B 

+ 

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS 
TASK CONTROL BLOCK 

. ASECT 

= 



T.LNK: ' 


L' 


.BLKW 1 


UTILITY LINK WORD 


T.PRI : ' 


L' 


.BLKB 1 


; TASK PRIORITY 


T. IOC: ' 


L' 


.BLKB 1 


I/O PENDING COUNT 


T. PCBV: 


•L 


1 .BLKW 1 


POINTER TO COMMON PCB VECTOR 


T . NAM : ' 


L' 


.BLKW 2 


TASK NAME IN RAD 50 


T . RCVL : 


•L 


' .BLKW 2 


RECEIVE QUEUE LISTHEAD 


T & C TT • 
1 • no I J-i • 


•L 


1 .BLKW 2 , 


ACT fNl" T T7 1 n I? r TOnPLII7Ar\ 


T.EFLG: 


•L 


' .BLKW 2 


TASK LOCAL EVENT FLAGS 1-32 


1 • ULo . 


L' 


.BLKW 1 , 


UCB ADDRESS FOR PSEUDO DEVICE 'TI' 


T.TCBL: 


•L 


1 .BLKW 1 


TASK LIST THREAD WORD 


T.STAT: 


•L 


• .BLKW 1 


FIRST STATUS WORD (BLOCKING BITS) 


T.ST2: ' 


L' 


.BLKW 1 


•SECOND STATUS WORD (STATE BITS) 


T.ST3: ' 


L' 


.BLKW 1 


THIRD STATUS WORD (ATTRIBUTE BITS) 


T.DPRI : 


'L 


' .BLKB 1 


TASK'S DEFAULT PRIORITY 


T.LBN: 1 


L' 


.BLKB 3 


LBN OF TASK LOAD IMAGE 


T.LDV: 1 


L' 


.BLKW 1 


UCB ADDRESS OF LOAD DEVICE 


T . PCB : 1 


L' 


.BLKW 1 , 


PCB ADDRESS OF TASK PARTITION 


T.MXSZ: 


•L 


' .BLKW 1 


■MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY) 


T.ACTL: 


■L 


1 .BLKW 1 , 


ADDRESS OF NEXT TASK IN ACTIVE LIST 


T. ATT: 1 


L 1 


.BLKW 2 


; ATTACHMENT DESCRIPTOR LISTHEAD 


T.ST4: ' 


L' 


.BLKW 1 


FOURTH TASK STATUS WORD 


T.HDLN: 


1 L 


1 .BLKB 1 


LENGTH OF HEADER (0 IF HDR IN POOL) 




., BLKB 1 , 


UNUSED 


T.GGF: 1 


L" 


.BLKB 1 


GROUP GLOBAL USE COUNT FOR TASK 


T.TIO: 1 


L" 


.BLKB 1 


BUFFERED I/O IN PROGRESS COUNT 


T.EFLM: 


' L 


' .BLKW 2 


TASK WAITFOR MASK/ADDRESS 


T.TKSZ: 


■L 


' .BLKW 1 , 


TASK LOAD SIZE IN 32 WD BLOCKS 


$$$=. 




;MARK START OF PLAS AREA 


T . OFF : ' 


L* 


.BLKW 1 ; OFFSET TO TASK IMAGE IN PARTITION 




.BLKB 1 


■RESERVED 


T.SRCT: 


•L 


' .BLKB 1 ;SREF WITH EFN COUNT IN ALL RECEIVE QUEUES 


T.RRFL: 


'L 


' .BLKW 2 


RECEIVE BY REFERENCE LISTHEAD 



..IF NDF P$$LAS 



.=$$$ ;MOVE LC BACK TO START OF PLAS AREA 

.. ENDC 

..IF NB SYSDEF 

$$$=. 
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T.CTX: ' L ' . BLKW 1 

. IF NDF N$$DIR 

.=$$$ 

. ENDC ; NDF N$$DIR 

$$$=. 

T.OCBH: 'L 1 .BLKW 2 
T.RDCT: 'L • .BLKW 1 



; POINTER TO CONTEXT BLOCK (DDS) 



;MARK START OF PARENT/OFFSPRING AREA 

;OFFSPRING CONTROL BLOCK LISTHEAD 

; OUTSTANDING OFFSPRING AND VT : COUNT 



.=$$$ 



.IF NDF P$$OFF 



.ENDC 



T.SAST: 'L 1 .BLKW 1 
$$$=. 

T.RRM: 'L 1 .BLKW 1 
T.I RM : 'L' .BLKW 1 



T.CPU: 'L' . BLKB 1 
. BLKB 1 



.=$$$ 



.IF NDF M$$PRO 



. ENDC 



;SPECIFY AST LIST HEAD 



REQUIRED RUN MASK 

INITIAL RUN MASK SET UP BY INSTALL 
**** THIS WORD IS NO LONGER NECESSARY 
**** HOWEVER, INSTALL ( INS LB) , MCR (SPAWN), 
**** AND VMR MUST BE MODIFIED 

PROCESSOR NUMBER ON WHICH TASK LAST EXECUTED 
(UNUSED) 



$$$ = . 

T. ACN: 'L ' .BLKW 1 



; POINTER TO ACCOUNTING BLOCK 



= $$$ 



.IF NDF A$$CNT 



, ENDC 



$$$ = . 

T. ISIZ: 'L' .BLKW 1 

•IF NDF U$$DAS 



;SIZE OF ROOT I SPACE 
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.=$$$ 



. ENDC 



NDF U$$DAS 



T.LGTH='B ' . 
T.EXT='B'0 

. IFF 



; LENGTH OF TASK CONTROL BLOCK 
; LENGTH OF TCB EXTENSION 



TASK STATUS DEFINITIONS 

FIRST STATUS WORD (BLOCKING BITS) 



TS.EXE='B"100000 
TS.RDN= 'B " 40000 
TS.MSG='B"20000 
TS.CIP= 'B ' 10000 
TS.RUN='B '4000 
TS.STP= 'B ' 1000 
TS.CKR='B'100 
TS.BLC='B'37 



TASK NOT IN EXECUTION (1=YES) 

I/O RUN DOWN IN PROGRESS (1=YES) 

ABORT MESSAGE BEING OUTPUT (1=YES) 

TASK BLOCKED FOR CHECKPOINT IN PROGRESS (1=YES) 

TASK IS RUNNING ON ANOTHER PROCESSOR (1=YES) 

TASK BLOCKED BY CLI COMMAND 

TASK HAS CKP REQUEST (MP SYSTEM ONLY) (1=YES) 
INCREMENT BLOCKING COUNT MASK 



TASK BLOCKING STATUS MASK 

TS.BLK= , B'177777 
+ 

SECOND STATUS WORD (STATE BITS) 



T2. 


AST = 


'B 


100000 


AST IN PROGRESS (1=YES) 


T2. 


DST = 


'B 


40000 


?AST RECOGNITION DISABLED (1=YES) 


T2. 


CHK= 


'B 


20000 


TASK NOT CHECKPOINTABLE (1=YES) 


T2. 


REX= 


•B 


10000 


■REQUESTED EXIT AST SPECIFIED 


T2. 


SEF = 


'B 


4000 


TASK STOPPED FOR EVENT FLAG (S ) (1 


T2. 


SIO = 


•B 


1000 


TASK STOPPED FOR BUFFERED I/O 


T2. 


AFF = 


•B 


400 


TASK IS INSTALLED WITH AFFINITY 


T2. 


HLT = 


•B 


200 


•TASK IS BEING HALTED (1=YES) 


T2. 


ABO = 


'B 


100 


TASK MARKED FOR ABORT (1=YES) 


T2. 


STP= 


'B 


40 


SAVED T2.SPN ON AST IN PROGRESS 


T2. 


STP = 


•B 


20 


TASK STOPPED (1=YES) 


T2. 


SPN= 


'B 


10 


'SAVED T2.SPN ON AST IN PROGRESS 


T2. 


SPN = 


'B 


4 , 


TASK SUSPENDED (1=YES) 


T2. 


WFR = 


'B 


2 


SAVED T2.WFR ON AST IN PROGRESS 


T2. 


WFR = 


B 


1 


TASK IN WAITFOR STATE (1=YES) 



THIRD STATUS WORD (ATTRIBUTE BITS) 



T3.ACP='B'100000 
T3. PMD= 'B 1 40000 
T3.REM='B'20000 
T3.PRV= 'B ' 10000 



; ANCILLARY CONTROL PROCESSOR (1=YES) 
;DUMP TASK ON SYNCHRONOUS ABORT (0=YES) 
; REMOVE TASK ON EXIT (1=YES) 
; TASK IS PRIVILEGED (1=YES) 
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T3 


. MCR = 


'B 


4000 


TASK REQUESTED AS EXTERNAL MCR FUNCTION f 1 =YP<?> 


T3 


. SLV= 


•b 


2000 


TASK IS A SLAVE TASK (1=YES) 


T3 


.CLI = 


•B 


1000 


TASK IS A COMMAND LINE INTERPRETER (1=YES) 


T3 


. RST = 


'B 


400 


TASK IS RESTRICTED (1=YES) 


T3 


.NSD = 


B 


200 


TASK DOES NOT ALLOW SEND DATA 


T3 


.CAL = 


'B 


100 


TASK HAS CHECKPOINT SPACE IN TASK IMAGE 


T3 


. ROV= 


B 


40 


TASK HAS RESIDENT OVERLAYS 


T3 


. NET = 


•B 


20 


NETWORK PROTOCOL LEVEL 


T3 


. MPC = 


'B 


10 


MAPPING CHANGE WITH OUTSTANDING I/O (1=YES) 


T3 


.CMD = 


•B 


4 


•TASK IS EXECUTING A CLI COMMAND 


T3 


.SWS = 


'B 


2 


RESERVED FOR SOFTWARE SERVICES USE 


T3 


. GFL = 


•B 


1 


GROUP GLOBAL EVENT FLAG LOCK 



+ 

STATUS BIT DEFINITIONS FOR FOURTH STATUS WORD (T.ST4) 



T4.FMP='B '200 ;TASK 

T4.CTC= 'B 1 100 ; TASK 

T4.MUT='B'40 ; TASK 

T4.LDD='B'20 ; TASK 

T4.PRO='B'10 ;TCB 

T4.PRV='B'4 ; TASK 

;WITH 

T4.DSP='B'2 ; TASK 

T4.SNC='B'l ; TASK 



HAS FAST MAP HDR EXT. 

HAS BEEN PROCESSED BY GIN *C ABORT 

IS A MULTI-USER TASK 
■S LOAD DEVICE HAS BEEN DISMOUNTED 
IS (OR SHOULD BE) A PROTOTYPE 

WAS PRIV, BUT HAS CLEARED T3.PRV 

GIN (MAY RESET WITH GIN IF T4.PRV SET) 

WAS BUILT FOR USER I/D SPACE 

USES COMMONS FOR SYNCHRONIZATION 



+ 

REQUIRED RUN MASK 



TR. UBT= 


'B 


■100000 ( 


UNIBUS 


RUN T 


TR.UBS= 


'B 


•40000 


UNIBUS 


RUN S 


TR . UBR= 


'B 


•20000 


UNIBUS 


RUN R 


TR.UBP= 


•B 


' 10000 


UNIBUS 


RUN P 


TR . UBN= 


B 


•4000 ; 


UNIBUS 


RUN N 


TR . UBM= 


'B 


•2000 


UNIBUS 


RUN M 


TR. UBL= 


B 


' 1000 


UNIBUS 


RUN L 


TR . UBK= 


•B 


•400 


UNIBUS 


RUN K 


TR.UBJ= 


'B 


•200 


UNIBUS 


RUN J 


TR . UBH= 


•B 


' 100 


UNIBUS 


RUN H 


TR. UBF= 


'B 


•40 


UNIBUS 


RUN F 


TR . UBE= 


•B 


'20 


•UNIBUS 


RUN E 


TR.CPD= 


■B 


•10 


PROCESSOR D 


TR.CPC= 


•B 


•4 


PROCESSOR C 


TR.CPB= 


'B 


'2 


PROCESSOR B 


TR.CPA= 


'B 


•1 


PROCESSOR A 



. ENDC 



. PSECT 

.MACRO TCBDF$ X,Y,Z 
. ENDM 
. ENDM 
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.MACRO UCBDF $ , L , B , TTDEF 

+ 

UNIT CONTROL BLOCK 

THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL DEVICE 
UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE FIRST WORD OF 
AN ASSIGNED LUN. THERE IS ONE UCB FOR EACH DEVICE UNIT OF EACH DCB . THE 
UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE CONTIGUOUS IN MEMORY AND ARE 
POINTED TO BY THE DCB. UCB'S ARE VARIABLE LENGTH BETWEEN DCB ' S BUT ARE 
OF THE SAME LENGTH FOR A SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE 
ABOVE, EACH UNIT ON BOTH INTERFACES WOULD HAVE A UCB. 

.ASECT 

=177772 



.IF NB SYSDEF 

.IF DF A$$CNT 

. =.-2 

. ENDC ; DF A$$CNT 

.IF DF L$$GCL 

. =.-2 

.ENDC ; DF L$$GCL 

.=.-2 

.IF DF N$$DIR 

. =.-2 

., ENDC ; DF N$$DIR 

U . UAB : 1 L " 

,. IF DF A$$CNT 

.BLKW 1 ; POINTER TO USER ACCOUNT BLOCK 

•ENDC ; DF A$$CNT 

U. LOG: "L 1 

.IF DF L$$GCL 

.BLKW 1 ; POINTER TO USER LOGICAL HASH TABLE 

.ENDC ; DF L$$GCL 



U.FPRO: ' L ' 

.BLKW 1 ; DEFAULT FILE PROTECTION WORD 
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U.CTX: 'L' 

. IF DF N$$DIR 

. BLKW 1 ; POINTER TO TERMINAL CONTEXT BLOCK 

. ENDC ; DF N$$DIR 



. ENDC ;NB SYSDEF 



U.MUP: ' L ' .BLKW 1 
U.LUTC: 'L' .BLKW 1 
U.OWN: 'L' .BLKW 1 
U.DCB: 'L' .BLKW 1 
U. RED: 'L' .BLKW 1 
U.CTL: 'L' . BLKB 1 
U.STS: 'L 1 .BLKB 1 
U.UNIT: 'L' .BLKB 1 
U.ST2: 'L • .BLKB 1 
U.CW1: 'L' .BLKW 1 
U.CW2: 'L' .BLKW 1 
U.CW3: 'L' .BLKW 1 
U.CW4: 'L ' .BLKW 1 
U.SCB: 'L' .BLKW 1 
U.ATT: 'L' .BLKW 1 
U.BUF: 'L ' .BLKW 1 
.BLKW 1 

U.CNT: 'L 1 .BLKW 1 
U.UCBX=»B'U.CNT+2 
U.ACP= 'B 'U.CNT+4 

U.VCB='B 'U.CNT+6 
U.CBF= 'B ' U.CNT +2 
U. UMB= 'B 'U.CNT+10 
U.PRM='B 'U.CNT+12 
U . ICSR= 'B'U.CNT+16 
U.SLT =, B' U.CNT +20 
U.SPRM='B'U.CNT+22 
U.UTIL='B'U.CNT+16 



DEFINITIONS FOR U.UTIL BITS 



uu. 


SER 




B 


1 


; SER I AL MODE 


uu. 


RCT 




'B 


2 


;(DUDRV)RCT IN PROGRESS 


uu. 


AVN 





B 


4 


IS WAITING FOR OTHER UNITS TO SPIN DOWN 


uu. 


GUS 




'B 


10 


;UNIT MUST HAVE A GUS COMMAND ISSUED 


uu. 


ONL 




'B 


20 


;UNIT MUST HAVE A ONL COMMAND ISSUED 


uu. 


SPC 




'B 


40 


;SPECIAL ONLINE TRANSITION 


uu. 


ATN 




'B 


100 


;UNIT HAS SENT ATTENTION MESSAGE 


uu. 


RDY 




'B 


200 


;UNIT IS READY 


uu. 


ABO 




'B 


400 


;IF SET, XXCAN SET UU.SER FLAG FOR UNIT 


uu. 


SIO 




'B 


1000 


;THIS UNIT CAN STALL I/O 


uu. 


IOS 


_ 


B 


2000 


;THIS UNIT HAS I/O STALLED 


uu. 


BLK 




•B 


4000 


;THIS UNIT DOESN'T ACCEPT DENSITY SETTINGS 



MULTI-USER PROTECTION WORD 
:LOGIN UIC - MULTI USER SYSTEMS ONLY 
OWNING TERMINAL - MULTI USER SYSTEMS ONLY 
:BACK POINTER TO DCB 
POINTER TO REDIRECT UNIT UCB 
:CONTROL PROCESSING FLAGS 
UNIT STATUS 
PHYSICAL UNIT NUMBER 
UNIT STATUS EXTENSION 
FIRST DEVICE CHARACTERISTICS WORD 
SECOND DEVICE CHARACTERISTICS WORD 
THIRD DEVICE CHARACTERISTICS WORD 
FOURTH DEVICE CHARACTERISTICS WORD 
POINTER TO SCB 

TCB ADDRESS OF ATTACHED TASK 
RELOCATION BIAS OF CURRENT I/O REQUEST 
BUFFER ADDRESS OF CURRENT I/O REQUEST 

BYTE COUNT OF CURRENT I/O REQUEST 

POINTER TO UCB EXTENSION IN SECONDARY POOL 

ADDRESS OF TCB OF MOUNTED ACP 

ADDRESS OF VOLUME CONTROL BLOCK 
CONTROL BUFFER RELOCATION AND ADDRESS 
ADDRESS OF UMB FOR SHADOW RECORDING 
DISK SIZE PARAMETER WORDS 
CSR ADDRESS (P/OS) 
SLOT ADRESS (P/OS) 

4 WD SAVED I/O PACKET AREA (R$$AMD ) 
STATE WORD FOR UNIT 
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U.BPKT='B'U.CNT+20 ;UNIT BAD BLOCK REPLACEMENT WAITING LIST 

U.MEDI= 'B "U.BPKT ;MEDIA IDENTIFIER FOR MU TAPE 

U.UC2X= 'B 'U.CNT+24 ; POINTER .TO SECOND EXTENSION IN SECONDARY POOL 



MAGTAPE DEVICE DEPENDENT UCB OFFSETS 



U.SNUM= , B'U.CNT+10 
U.FCDE= 'B * U.CNT + 12 
U.KRB1='B'U.CNT+14 



;SLAVE UNIT NUMBER 

;FUNCTION CODE 

; SUBCONTROLLER KRB1 POINTER 



DEFINE SECONDARY POOL UCB EXTENSION OFFSETS (ERROR LOGGING DEVICES ONLY) 



.=0 

. BLKW 9. 
X . NAME : 'L' .BLKW 2 
X. IOC: ' L ' .BLKW 2 
X.ERSL: 'L' . BLKB 1 
X. ERHL: 'L ' .BLKB 1 
X.ERSC: 'L' .BLKB 1 
X. ERHC : ' L ' .BLKB 1 
X.WCNT: 'L' .BLKW 2 



;FIXED ACCOUNTING TRANSACTION HEADER 

; DRIVE NAME IN RAD 50 

;I/0 COUNT 

;SOFT ERROR LIMIT 

; HARD ERROR LIMIT 

;SOFT ERROR COUNT 

;HARD ERROR COUNT 

;WORDS TRANSFERED COUNT 



DEFINE OFFSETS FOR SEEK OPTIMIZATION DEVICES 



X.CYLC 


'L 




.BLKW 


2 


CYLINDERS CROSSED COUNT 


X.CCYL: 'L 




.BLKW 


1 


^CURRENT CYLINDER 


X.FCUR 


: 'L 




.BLKB 


1 


"CURRENT FAIRNESS COUNT 


X.FLIM 


'L 








; FAIRNESS COUNT LIMIT 


X.DSKD 


'L 




.BLKB 


1 


•DISK DIRECTION (HIGH BIT l=OUT) 


X.DNAM 


'L 




.BLKW 


1 


; DEVICE NAME FOR ACCOUNTING 


X.UNIT 


: 'L 




.BLKB 


1 


•UNIT NUMBER FOR ACCOUNTING 


X.CSTS 


•L 




.BLKB 


1 


;CACHE STATUS BITS 


X.CPCB 


■L 




.BLKW 


1 


•CACHE PARTITION PCB ADDRESS 


X.CSBA 


'L 




.BLKW 


1 


;CACHE STATISTICS BUFFER ADDRESS (BIAS) 


X.CCED 


•L 




.BLKW 


2 


CACHE EXTENT DESCRIPTOR LISTHEAD 


X.XDAT 


'L 




.BLKB 


1 


?CACHE VIRTUAL EXTENT SIZE 


X. XRDA 


'L 




.BLKB 


1 


CACHE READAHEAD EXTENT SIZE 


X.XDIR 


•L 




.BLKB 


1 


;CACHE DIRECTORY EXTENT SIZE 


X.XLOG 


•L 




.BLKB 


1 , 


CACHE LOGICAL EXTENT SIZE 


X.XOVR 


•L 




.BLKB 


1 


;CACHE OVERLAY EXTENT SIZE 








.BLKB 


1 


RESERVED 


X . LGTH= 


= «B 








LENGTH OF THE UCB EXTENSION 


X. DFFL= 




10. 




DEFAULT FAIRNESS COUNT LIMIT 


X.DFSL= 


= 'B 


8 






DEFAULT SOFT ERROR LIMIT 


X. DFHL= 


= 'B 


5 






DEFAULT HARD ERROR LIMIT 



CACHE STATUS BITS IN X.CSTS 
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XC.ENA= 'B' 200 
XC.ACT='B'100 
XC . D I R = 1 B ' 020 
XC .OVR= 'B ' 010 
XC . DAT= ' B ' 004 
XC.LOG= , B , 002 
XC . RDA= 'B 1 001 



;AUTOCACHE ENABLED (1=YES) 
;CACHE ACTIVE FOR DEVICE (1=YES) 
;CACHE DIRECTORY REQUESTS (1=YES) 
;CACHE OVERLAY REQUESTS (1=YES) 
;CACHE VIRTUAL REQUESTS (1=YES) 
;CACHE LOGICAL REQUESTS (1=YES) 
;CACHE VIRTUAL READ AHEAD (1=YES) 



DEFINE CACHE MAXIMUM AND DEFAULT EXTENT SIZES 



XX.MAX='B'15. 
XX.DAT= 'B • 5. 
XX.RDA='B I 5. 
XX.DIR= ! B • 1. 
XX.LOG='B'l. 
XX.OVR= 'B ' 4. 



MAXIMUM EXTENT SIZE 
DEFAULT VIRTUAL EXTENT SIZE 
DEFAULT READAHEAD EXTENT SIZE 
DEFAULT DIRECTORY EXTENT SIZE 
DEFAULT LOGICAL EXTENT SIZE 
DEFAULT OVERLAY EXTENT SIZE 



DEFINE OFFSETS FOR DISK MSCP CONTROLLERS (SECOND UCB EXTENSION) 



CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS 



= 



X. 


MLUN: 


'L 


' . BLKW 


1 


;MULTI-UNIT CODE 


X. 


UNFL : 


■L 


' .BLKW 


1 


;UNIT FLAGS 








.BLKW 


2 


; RESERVED 


X. 


UNTI : 


'L 


' .BLKW 


4 


;UNIT IDENTIFIER 


X. 


MEDI : 


•L 


' .BLKW 


2 


;MEDIA IDENTIFIER 


X. 


SHUN: 


'L 


' .BLKW 


1 


; SHADOW UNIT 


X. 


SHST: 


'L 


• .BLKW 


1 


JSHADOW UNIT STATUS 


X. 


TRCK: 


•L 


■ .BLKW 


1 


;UNIT TRACK SIZE 


X. 


GRP: ' 


L ' 


.BLKW 


1 


;UNIT GROUP SIZE 


X. 


CYL: 1 


L 1 


.BLKW 


1 


;UNIT CYLINDER SIZE 


X. 


USVR: 


'L 


' . BLKB 


1 


;UNIT SOFTWARE VERSION 


X. 


UHVR: 


•L 


' .BLKB 


1 


;UNIT HARDWARE VERSION 


X. 


RCTS: 


•L 


' .BLKW 


1 


;UNIT RCT TABLE SIZE 


X. 


RBNS: 


'L 


• .BLKB 


1 


;UNIT RBN ' S / TRACK 


X. 


RCTC: 


'L 


1 .BLKB 


1 


;UNIT RCT COPIES 



CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS' 
PACKETS 



END 



X. UNSZ : ' L ' .BLKW 2 
X.VSER: 'L' .BLKW 2 



;UNIT SIZE 

;VOLUME SERIAL NUMBER 



X.DUSZ='B' . 



;SIZE OF DISK MSCP CONTROLLER UCB EXTENT ION 



.IF NB TTDEF 



TERMINAL DRIVER DEFINITIONS 



C-78 



RSX-11M-PL0S SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



UCBDF$ (Cont.) 



. =U.BUF 
U.TAPR: 'L' 
U.TUX: 'L ' 
U.TSTA: 'L ' 
U.UIC: "L 1 
U.TFRQ: ' L 1 
U.TFLK: 'L' 
U.TCHP: 'L* 
U.TCVP: ' L ' 
U.TTYP: 1 L ' 
U.TMTI : 'L' 
U.TTAB: ' L ' 



. BLKW 1 

.BLKW 4 
.BLKW 1 

.BLKW 1 

.BLKW 

• BLKB 

. BLKB 

.BLKB 

.BLKB 

.BLKW 



U.TBSZ 
U.TLPP 
U.TST5 
U.TST6 
U.TIXL 
U . ACB : 
U.AFLG: 
U . ADMA : 



; 'L' 
'L' 
: 'L' 
'L' 

: 'L' 
'L * 
'L' 
'L' 



= .-2 



U.TECO: 'L' .BLKB 1 



.BLKB 1 

.BLKW 1 

.BLKW 1 

.BLKW 1 

.BLKW 1 
.BLKW 1 

.BLKW 1 

.BLKW 1 



APR VALUE FOR START OF UCBX 

POINTER TO UCB EXTENSION (UCBX) 

STATUS QUADRUPLE-WORD 

DEFAULT UIC 

FORK REQUEST WORD 

FORK LIST LINK WORD 

CURRENT HORIZONTAL POSITION 

CURRENT VERTICAL POSITION 

TERMINAL TYPE 

MODEM TIMER 

IF 0: U.TTAB+1 IS SINGLE-CHARACTER TYPE-AHEAD 

BUFFER, CURRENTLY EMPTY 
IF ODD: U.TTAB+1 IS SINGLE-CHARACTER TYPE-AHEAD 

BUFFER AND HOLDS A CHARACTER 
IF NON-0 AND EVEN: POINTER TO MULT I -CHARACTER 

TYPE-AHEAD BUFFER 
THE NEXT TWO OFFSETS OVERLAP U.TTAB WHEN THE 
TYPEAHEAD BUFFER IS IN SECONDARY POOL 
ECHO BUFFER FOR DMA OPERATIONS WHEN UCBX IS 
IN SECONDARY POOL AND THUS NOT MAPPED BY A UMR 
TYPEAHEAD BUFFER SIZE 
LINES PER PAGE 
ADDITIONAL STATUS BITS 
EXTENDED I/O STATUS WORD 
I/O PACKET EXTENSION LISTHEAD 
ANCILLARY CONTROL DRIVER BLOCK ADDR 
ANCILLARY CONTROL DRIVER FLAGS WORD 
ANCILLARY CONTROL DRIVER DMA BUFFER 



.IF DF T$$LTH 



LAT Host Support 

; STATUS/CONTROL INFORMATION 



u. 


LINS: 


'L' 


.BLKB 


1 


; LINK STATUS 


u. 


CREN: 


'L' 


.BLKB 


1 


; TRANSMIT CREDITS COUNTER 
;SERVER/CIRCUIT IDENTIFICATION 


u. 


SRVN: 


■L' 


.BLKW 


1 


; SERVER NUMBER 


u. 


SESN: 


•L" 


.BLKB 


1 


;SESSION NUMBER 


u. 


SLSZ: 


•L' 


.BLKB 


1 


; MAXIMUM SLOT SIZE ON XMT 
; PARAMETERS ON RECEIVE DATA 


u. 


RSBB: 


' L 1 


.BLKW 


1 


; RECEIVE SLOT BIAS 


u. 


RBHA: 


•L' 


.BLKW 


1 


;RECEIVE SLOT HEADER VIRTUAL 


u. 


RSDV: 


'L' 


.BLKW 


1 


; RECEIVE DATA VIRTUAL 
;XMT INTERMEDIATE BUFFER CHAIN 


u. 


TRLH: 


'L' 


.BLKW 


1 


;XMT LISTHEAD ADDRESS 


u. 


TRSC: 


'L' 


.BLKW 


1 


;XMT REMAINED BYTES IN BUFFER 
;VIRTUAL CIRCUIT CCB 


u. 


CCBA: 


'L ■ 


.BLKW 


1 


;CCB ADDRESS (IN POOL) 



LINK STATUS WORD IN U.LINS 



UL.TRS='B'l 



;1-XMT STOPPED, 0-NOT 

;>255 CHAR. FOR SLOT. HOLD IT. 



RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 

UCBDFS (Cont.) 



UL . TDA= 'B 1 2 
UL.LST= 'B ' 4 

UL . RDA= 'B ' 10 
UL . ECH= 1 B 1 20 
UL.RSS= 'B 1 100 

UL . LEN= ' B ' 200 
. ENDC 



1-XMT DATA AVAIL, 0-NOT 

DATA IN XMT QUEUE (SET BY PORT) 

1-LINE STOPPED , 0-NOT 

LINE STOPPED BY USER (XOFF 

CAME FROM REMOTE TERMINAL) 

1-RCV DATA AVAIL, 0-NOT 

DATA IN RCV QUEUE (SET BY PROC) 

BUFFER ALLOCATION FAILURE 

FOR 1 ECHO CHARACTER 

1-RCV STOPPED, 0-NOT 

RCV STOPPED BY TTDRV ON RECEIVE 

IF NO RESOURCES AVAILABLE 

1-LINK ENABLE, 0-NOT 

TOGGLED BY START/STOP LINK CALL 



.IF DF T$$LTH 



DEFINE BITS IN STATUS WORD 1 (U.TSTA) 



INPUT 



STATUS 



S1.RST = 
S1.ESC= 
S1.RSP= 
SI. PTH = 
SI. RNE = 
S1.TSY = 
S1.0BY= 
SI. IBY = 
S1.DPR = 
S1.DEC= 
SI. IBF = 
S1.DSI = 
S1.RES= 



•B '1 

•B'2 

'B'4 

'B'10 

'B'20 

'B'40 

•B'100 

•B '200 

'B'4 00 

'B ' 1000 

'B'2000 

•BMOOO 

■B'10000 



SI. RNF= 'B ' 20000 

S1.TNE= 'B 1 40000 
S1.USI='B , 100000 



READ WITH SPECIAL TERMINATORS IN PROGRESS 
ESCAPE SEQUENCE IN PROGRESS 
READ WITH SPECIAL PROCESSING 
PASS THRU IS CURRENTLY ACTIVE 
ECHO SUPPRESSED 

TERMINAL OUTPUT SYNC IS CURRENTLY ENABLED 
OUTPUT BUSY 
INPUT BUSY 

DEFER PROCESSING OF CHAR. IN U.TECB 
DEFER ECHO OF CHAR. IN U.TECB 
BUFFERED INPUT IN PROGRESS 
INPUT PROCESSING DISABLED 

ESC. SEQ PROCESSING IS ENABLED FOR THE CURRENT 
READ 

READ NO FILTER IS ACTIVE (EDIT CHARACTERS ARE 

DISPLAYED) 
TERMINATOR NO ECHO 
UNSOLICITED INPUT IN PROGRESS 



DEFINE BITS IN STATUS WORD 2 (U.TSTA+2) 



OUTPUT 

S 2 . RCU= ' B ' 1 
S 2 . WRA= 1 B ' 6 
S2.WRB= 'B 1 2 
S2.WAL= 'B 1 10 
S2.BRQ='B'20 
S2.SRQ= 'B' 40 

S2.ORQ='B'100 
S2. IRQ='B'200 
S2.FLF= 'B 1 400 
S2. ELF= 'B * 1000 
S 2 . CR= ' B ' 2000 
S2.0BF='B '4000 



STATUS 



RESTORE CURSOR (MUST = TF.RCU) 

CONTEXT FOR WRAP-AROUND 

LOW BIT IN S2.WRA BIT PATTERN 

WRITE PASS ALL (MUST = TF.WAL) 

BREAK-THROUGH-WRITE REQUEST IN QUEUE 

SPECIAL REQUEST IN QUEUE 

(IO. ATT, IO.DET, SF.SMC) 

OUTPUT REQUEST IN QUEUE (MUST = Sl.OBY) 
INPUT REQUEST IN QUEUE (MUST = Sl.IBY) 
FORCE LINEFEED BEFORE NEXT ECHO 

EAT A LINEFEED (IGNORE A LEADING LF ON OUTPUT) 
TRAILING CR REQUIRED ON OUTPUT 
BUFFERED OUTPUT IN PROGRESS 
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S2.PCU='B'10000 ;POSITION CURSOR BEFORE WRITE 

S2.BEL='B' 20000 ;BELL PENDING 

S2.CTO='B'40000 ;OUTPUT STOPPED BY CTRL-0 266. 

S2.CTS='B' 100000 ;OUTPUT STOPPED BY CTRL-S 



DEFINE BITS IN STATUS WORD 3 (U.TSTA+4) 



TERMINAL OPERATION CHARACTERISTICS 



S3. 


ACR = 


'B 


1 


WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED 


S3. 


TAB = 


•B 


2 


; TYPE-AHEAD BUFFER ALLOCATION REQUESTED 


S3. 


CTC = 


•B 


4 


TERMINAL WANTS CLI TO HAVE *C NOTIFICATION 


S3. 


RAL = 


'B 


10 


* TERMINAL IS IN READ-PASS-ALL MODE 


S3. 


NEC = 


•B 


20 


•NO ECHO 


S3. 


TSY= 


'B 


40 


; TERMINAL SYNC 


S3. 


8BC= 


'B 


100 


PASS 8 BITS ON INPUT 


S3. 


FDX= 


'B 


200 


; LINE IS IN FULL DUPLEX MODE 


S3. 


MHE = 


'B 


400 


NOTIFY ATTACHED TASK OF MODEM HANG-UP 


S3. 


ICE = 


'B 


1000 


•INPUT COUNT STATE ENABLED 


S3. 


TME = 


B 


2000 


TERMINAL MANAGEMENT MODE ENABLED 


S3. 


PTH = 


B 


4000 


PASS THROUGH REQUESTED 


S3. 


RES = 


B 


10000 


TASK WANTS ESCAPE SEQUENCES 


S3. 


PPT = 


B 


20000 


TERMINAL HAS PRINTER PORT 


S3. 


RUB = 


B 


40000 


RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE) 



DEFINE BITS IN STATUS WORD 4 (U.TSTA+6) 



TERMINAL ATTRIBUTE CHARACTERISTICS 



S4. 


HFL = 


B 


7 


HORIZONTAL FILL REQUIREMENT 


S4. 


VFL = 


B 


10 


VERTICAL FILL REQUIREMENT 


S4. 


HFF = 


B 


20 


HARDWARE FORM-FEED PRESENT 


S4. 


HHT = 


'B 


40 


HARDWARE HORIZONTAL TAB PRESENT 


S4. 


DLO= 


B 


100 


DIAL-OUT LINE (IMPLIES U2.RMT) 


S4. 


HSY = 


'B 


200 


HOST/TERMINAL SYNCHRONIZATION ENABLED (1=YES) 


S4. 


ANI = 


'B 


400 


ANSI CRT TERMINAL 


S4. 


AVO= 


'B 


1000 


VT100-FAMILY TERMINAL DISPLAY 


S4. 


BLK= 


B 


2000 


BLOCK MODE TERMINAL 


S4. 


DEC = 


'B 


4000 


DIGITAL CRT TERMINAL 


S4. 


EDT= 


'B 


10000 


TERMINAL HAS LOCAL EDITING FUNCTIONS 


S4. 


RGS = 


'B 


20000 


TERMINAL SUPPORTS REGIS GRAPHICS 


S4. 


SFC = 


B 


40000 


TERMINAL SUPPORTS SOFT CHARACTERS (DRCS) 


S4. 


ABD= 


'B 


100000 


JAUTO-BAUD SPEED DETECTION ENABLED 



DEFINE BITS IN STATUS WORD U.TST5 
ADDITIONAL STATUS CHARACTERISTICS 



S5. 


SW1 = 


'B 


1 


;FIRST TERMINAL MANAGEMENT SWITCH 
;CHARACTER HAS BEEN SEEN 


S5. 


TMM = 


'B 


2 


; TERMI NAL IN TERMINAL MANAGEMENT MODE 


S5. 


XOF = 


'B 


4 


; SEND AN XOFF AT FIRST OPPORTUNITY 


S5. 


XON = 


'B 


10 


; SEND AN XON AT FIRST OPPORTUNITY 


S5. 


HPC= 


'B 


14 


; OUTPUT OF HIGH PRIORITY CHARACTERS REQUESTED 
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S5.HPO= , B , 20 
S5.OXF='B'40 
S5. ITI='B , 100 

S5.RPO= 'B ' 2000 
S5.VER= , B , 10000 

S5.BCC= , B , 20000 

S5.DAO= 'B '40000 



S5.ABP='B'100000 



; HIGH PRIORITY OUTPUT IN PROGRESS 

;XOFF HAS BEEN OUTPUT 

; IMMEDIATE TIMEOUT ON INPUT 

READ W/PROMPT OUTPUT IN PROGRESS 
LAST CHAR. IN TYPE-AHEAD BUFFER 
HAS PARITY ERROR 

LAST CHAR. IN TYPE-AHEAD BUFFER 
HAS FRAMING ERROR 

LAST CHAR. IN TYPE-AHEAD BUFFER 
HAS DATA OVERRUN ERROR 

NOTE - THE 3 BITS ABOVE MUST CORRESPOND 
TO THE RESPECTIVE ERROR FLAGS IN THE 
HARDWARE RECEIVE BUFFER 

AUTO-BAUD SPEED DETECTION IN PROGRESS 



DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6 



S6.EIO='B'400 

S6.RLU='B'1000 

S6.RDI='B'100000 



; READ WAS AN EXTENDED I/O 

; READ WITH LOWER CASE TO UPPER CASE CONVERSION 
; READ WITH DEFAULT INPUT 



. ENDC 



VIRTUAL TERMINAL UCB DEFINITIONS 



.=U.UNIT 

U . OCNT : ' L ' . BLKB 1 
. =U.BUF 

U.RPKT: 'L' . BLKW 1 
U.WPKT: 'L' .BLKW 1 
U. IAST: 'L' .BLKW 1 
U.OAST: 'L' .BLKW 1 
U . AAST : 'L 1 .BLKW 1 



;OFFSPRING WITH THIS AS TI : 

;CURRENT OFFSPRING READ I/O PACKET 
; CURRENT OFFSPRING WRITE I/O PACKET 
; INPUT AST ROUTINE ADDRESS 
; OUTPUT AST ROUTINE ADDRESS 
; ATTACH AST ROUTINE ADDRESS 



.IF NB TTDEF 
.IIF NE U . AAST+2-U . UIC .ERROR 
.ENDC 



; ADJACENCY ASSUMED 



. =U.AAST+4 

U. PTCB: 'L • .BLKW 1 



; PARENT TCB ADDRESS 



CONSOLE DRIVER DEFINITIONS 



.=U.BUF+2 

U.CTCB: 'L • .BLKW 1 

U.COTQ: 'L' .BLKW 2 

U.RED2: 1 L * .BLKW 1 



; ADDRESS OF CONSOLE LOGGER TCB 
;I/0 PACKET LIST QUEUE 
; RED I RECT UCB ADDRESS 
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.PSECT 



DEVICE TABLE STATUS DEFINITIONS 

DEVICE CHARACTERISTICS WORD 1 (U.CW1) DEVICE TYPE DEFINITION BITS. 



DV.REC= 
DV.CCL = 
DV.TTY= 
DV.DIR= 
DV. SDI = 
DV.SQD= 
DV.MSD= 
DV.UMD= 
DV.MBC= 
DV. EXT= 
DV.SWL= 
DV. ISP= 
DV. OSP = 
DV.PSE = 
DV.COM; 
DV.F11= 
DV.MNT = 



'B'l 
'B'2 
'B'4 
'B'lO 
'B'20 
'B'40 
'B'lOO 
'B'200 
'B'400 
'B'400 
'B'1000 
'B'2000 
:'B '4000 
"B'10000 
'B'20000 
"B'40000 
'B'lOOOOO 



RECORD ORIENTED DEVICE (1=YES) 

CARRIAGE CONTROL DEVICE (1=YES) 

TERMINAL DEVICE (1=YES) 

FILE STRUCTURED DEVICE (1=YES) 

SINGLE DIRECTORY DEVICE (1=YES) 

SEQUENTIAL DEVICE (1=YES) 

MASS STORAGE DEVICE (1=YES) 

USER MODE DIAGNOSTICS SUPPORTED (1=YES) 

MASSBUS CONTROLLER (11M COMPATIBILITY ONLY) 

UNIT ON EXTENDED 22-BIT UNIBUS CNTROLER (1=YES) 

UNIT SOFTWARE WRITE LOCKED (1=YES) 

INPUT SPOOLED DEVICE (1=YES) 

OUTPUT SPOOLED DEVICE (1=YES) 

PSEUDO DEVICE (1=YES) 

DEVICE IS MOUNTABLE AS COM CHANNEL (1=YES) 
DEVICE IS MOUNTABLE AS Fll DEVICE (1=YES) 
DEVICE IS MOUNTABLE (1=YES) 



TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2.DH1= 
U2.DJ1 = 
U2.RMT= 
U2.HFF= 
U2. L8S= 
U2.NEC= 
U2.CRT= 
U2.ESC= 
U2. LOG= 
U2.SLV= 
U2.DZ1 = 
U2.HLD= 
U2.AT.= 
U2.PRV= 
U2. L3S= 
U2.VT5= 
U2. LWC= 



"B'lOOOOO 

'BMOOOO 

■B '20000 

'B'10000 

'B'10000 

'B'4000 

'B'2000 

'B'1000 

'B'400 

«B'200 

'B'lOO 

•B'40 

'B'20 

'B'lO 

'B'4 

'B'2 

'B'l 



UNIT IS A MULTIPLEXER (1=YES) 
UNIT IS A DJ11 (1=YES) 
UNIT IS REMOTE (1=YES) 

UNIT HANDLES HARDWARE FORM FEEDS (1=YES) 
OLD NAME FOR U2.HFF 

DON'T ECHO SOLICITED INPUT (1=YES) 
UNIT IS A CRT (1=YES) 

UNIT GENERATES ESCAPE SEQUENCES (1=YES) 
USER LOGGED ON TERMINAL (0=YES) 
UNIT IS A SLAVE TERMINAL (1=YES) 
UNIT IS A DZ11 (1=YES) 

TERMINAL IS IN HOLD SCREEN MODE (1=YES) 

MCR COMMAND AT. BEING PROCESSED (1=YES) 

UNIT IS A PRIVILEGED TERMINAL (1=YES) 

UNIT IS A LA30S TERMINAL (1=YES) 

UNIT IS A VT05B TERMINAL (1=YES) 

LOWER CASE TO UPPER CASE CONVERSION (0=YES) 



BIT DEFINITIONS FOR U.MUP 
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UM.OVR= 


•B 


1 


; OVERRIDE CLI INDICATOR 


UM.CLI= 


'B 


36 


;CLI INDICATOR BITS 


UM.DSB= 


'B 


200 


; TERMINAL DISABLED SINCE CLI ELIMINATED 


UM.NBR= 


'B 


400 


;NO BROADCAST 


UM.CNT= 


'B 


1000 


CONTINUATION LINE IN PROGRESS 


UM.CMD= 


'B 


2000 


; COMMAND IN PROGRESS 


UM.SER= 


'B 


4000 


; SERIAL COMMAND RECOGNITION ENABLED 


UM.KIL= 


'B 


10000 


;TTDRV SHOULD SEND KILL PKT ON CNTRL/C 



+ 

RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 
U2.R04='B '100000 ;UNIT IS A RS04 (1=YES) 

+ 

RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 

U2. 7CH='B'10000 ;UNIT IS A 7 CHANNEL DRIVE (1=YES) 

+ 

TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS 

U3.UPC='B '20000 ;UPCASE OUTPUT FLAG 

U3.PAR='B'40000 ; PARITY GENERATION AND CHECKING 

U3. OPA= 'B ' 100000 ; PARITY SENSE (l=ODD PARITY) 

+ 

VIRTUAL TERMINAL 3RD CHARACTERISTICS WORD DEFINITIONS 
U3.FDX='B'l ; FULL DUPLEX MODE (1=YES) 

U3.DBF='B'2 ; INTERMEDIATE BUFFERING DISABLED (1=YES) 

U3.RPR='B'4 ; READ W/PROMPT IN PROGRESS (1=YES) 

+ 

TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS 

U4.CR='B'100 ;LOOK FOR CARRIAGE RETURN 

+ 

UNIT CONTROL PROCESSING FLAG DEFINITIONS 

; B YTE ALIGNMENT ALLOWED (l=NO) 
;DEVICE IS AN NPR DEVICE (1=YES) 
;CALL DRIVER BEFORE QUEUING (1=YES) 
;CALL DRIVER AT POWERFAIL ALWAYS (1=YES) 
;CALL DRIVER ON ATTACH/DETACH (1=YES) 
;CALL DRIVER AT I/O KILL ALWAYS (1=YES) 
; TRANSFER LENGTH MASK BITS 

+ 

UNIT STATUS BIT DEFINTIONS 



uc 


. ALG = 


'B 


200 


uc 


.NPR= 


■B 


100 


uc 


.QUE= 


'B 


40 


uc 


. PWF = 


'B 


20 


UC 


. ATT = 


'B 


10 


uc 


• KIL = 


'B 


4 


uc 


. LGH = 


B 


3 
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US.BSY='B'200 ;UNIT IS BUSY (1=YES) 

US.MNT= r B 1 100 ;UNIT IS MOUNTED (0=YES) 

US.FOR='B'40 ;UNIT IS MOUNTED AS FOREIGN VOLUME (1=YES) 

US.MDM='B'20 ;UNIT IS MARKED FOR DISMOUNT (1=YES) 

US.PWF='B'10 ;POWERFAIL OCCURED (1=YES). 

+ 

CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS 

US.ABO='B'l ;UNIT IS MARKED FOR ABORT IF NOT READY (1=YES) 

US.MDE='B'2 ;UNIT IS IN 029 TRANSLATION NODE (1=YES) 

+ 

FILES-11 DEPENDENT UNIT STATUS BITS 

US.WCK='B'10 ;WRITE CHECK ENABLED (1=YES) 

US.SPU='B'2 ;UNIT IS SPINNING UP (1=YES) 

US.VV='B'l ;VOLUME VALID IS SET (1=YES) 

+ 

TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS 

US.CRW='B I 4 ;UNIT IS WAITING FOR CARRIER (1=YES) 

US.DSB='B'2 ;UNIT IS DISABLED (1=YES) 

US.OIU='B'l ;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT (1=YES) 
+ 

LPS11 DEPENDENT UNIT STATUS BIT DEFINITIONS 

US.FRK='B'2 ; FORK IN PROGRESS (1=YES) 

US.SHR='B'l ; SHAREABLE FUNCTION IN PROGRESS (0='B'YES) 
+ 

ANSI MAGTAPE DEPENDENT UNIT STATUS BITS 

US.LAB="B'4 ; UNIT HAS LABELED TAPE ON IT (1=YES) 
+ 

UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS 

US.OFL='B'l ;UNIT OFFLINE (1=YES) 

US.RED='B'2 ;UNIT REDIRECT ABLE (0=YES) 

US.PUB='B'4 ;UNIT IS PUBLIC DEVICE (1=YES) 

US.UMD='B'10 ;UNIT ATTACHED FOR DIAGNOSTICS (1=YES) 

US.PDF='B'20 PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY (1=YES) 

US.MUN='B'40 ;MULTI-UNIT FLAG 

US.TRN= 'B'100 ;UNIT TRANSITION HAS OCCURRED (1=YES) 

US.SIO= 'B ' 200 ; STALL I/O TO UNIT (1=YES) 
+ 

MAGTAPE DENSITY SUPPORT DEFINITION IN U.CW3 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



UCBDF$ (Cont.) 



UNSUPPORTED 

200BPI, 7 TRACK 

556BPI, 7 TRACK 

800BPI, 7 OR 9 TRACK 
1600BPI, 9 TRACK 
6250BPI, 9 TRACK 

8K BPI - SERIAL, SERPENTINE RECORDING. 



•MACRO UCBDF$,X,Y,Z,A 
. ENDM 
. ENDM 



UU, UHO- D U 

UD. 200= , B , 1 
UD.556= , B'2 
UD .8 00= 'B '3 
UD.160='B'4 
UD. 625= 'B ' 5 
UD.8K='B'6 
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APPENDIX D 
MICRO/RSX COMMON ERROR CODE DEFINITIONS 



This appendix lists: 

1. Facility-independent error code definitions 

2. Standard Bugcheck formats for facility-defined error codes 



Common (Facility-Independent) Error Code Definitions 



SST-Type Errors - Error Code 1 



BE 


.ODD = 


= 000100 


Odd address or other trap four 


BE 


. SGF : 


■- 000102 


; Segment fault 


BE 


.BPT ■■ 


= 000104 


' Breakpoint or T-bit trap 


BE 


. IOT = 


= 000106 


; IOT instruction 


BE 


. ILI = 


= 000110 


Illegal instruction 


BE 


. EMT ••= 


= 000112 


; EMT instruction 


BE 


. TRP = 


= 000114 


• Trap instruction 


BE 


. STK = 


= 000116 


; Stack overflow 


t 




Internal Inconsistency Errors - Error Code 2 


BE 


. NPA = 


= 000200 


} Task with no parent aborted 


BE 


. SGN = 


= 000201 


; Feature not included in system 


BE 


. 2FR -- 


= 000202 


} Double fork 


BE 


. ISR -- 


= 000203 


; Interrupt service routine clobbered register 


BE 


. FHW = 


= 000204 


; Fatal hardware error 


BE 


.CSR = 


= 000205 


; Device CSR disappeared 


BE 


.IDC = 


= 000206 


; Internal database consistency error 


BE 


.ACP = 


= 000207 


; ACP task aborted 


BE 


.HSP = 


= 000210 


; Header subpacket problem 


BE 


. NCT = 


= 000211 , 


' No current task 


i 




System Pool Related Errors - Error Code 3 


BE 


. NPL = 


= 000300 


No pool for operation 


BE 


. DDA = 


= 000301 


; Double deallocation 


BE 


.SIZ = 


= 000302 


• Size of block invalid 


BE 


.BAK = 


= 000303 


; Deallocated block below pool 


BE 


.POV = 


= 000304 


Deallocation overlaps end of pool 


r 




Group-global Event Flag Errors - Error code 4 


BE 


. GGF = 


= 000400 ; Task locked to non-existent flags 



MICRO/RSX COMMON ERROR CODE DEFINITIONS 



Standard Bugcheck Format Facility Code Definitions 



; I/O Driver Subsystem - Facility Code 2 

BF.TTD = 000200 ; Terminal driver 



Executive Components - Facility Code 3 



BF. 


EXE -- 


- UUU jUU 


Exec 


— General and miscellaneous 


BF. 


XDT = 


= 000301 


; Exec 


- Executive Debugging Tool 


BF. 


POL = 


= 000303 


Exec 


- Pool handling routines (CORAL) 


BF. 


ERR = 


= 000304 


; Exec 


- Hardware error processing subsystem 


BF. 


INT = 


= 000305 


Exec 


- Internal consistency checking routine 


BF. 


INI = 


= 000306 


; Exec 


- INITL - initialization module 


BF. 


DVI = 


= 000307 


Exec 


- DVINT common interrupt handler 


BF. 


PAR = 


= 000310 


• Exec 


- Parity memory support 


BF. 


XIT = 


= 000311 


Exec 


- Task exit/abort procesing 


BF. 


QIO = 


= 000312 


Exec 


- QIO directive 


BF. 


OPT = 


= 000313 


Exec 


- Seek optimization 


BF.ACC = 


= 000314 


■ Exec 


- System resource accounting 


BF. 


KAS = 


= 000315 


Exec 


- Kernel AST support 


BF. 


DIR = 


= 000316 


• Exec 


- Miscellaneous directives 


BF. 


SAN = 


= 000317 ; 


Exec 


- Crash with sanity timer message 
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ABODF$, B-3, C-3 
ACNDF$, C-5 
/ACT , 2-4, 2-5 
Active task 

address of TCB, 3-21 

AST queue, 3-23 

attribute bits, 3-22 

blocking bits, 3-21 

MCR, 3-26 

name, 3-21 

Offspring Control Block, 3-23 
partition, 3-21 
receive queue, 3-23 
recei ve-by-ref erence queue, 
3-24 

state bits, 3-22 

task image, 3-21 
Active task dump, 3-21 

AST queue, 3-21 

Offspring Control Block, 3-21 

receive queue, 3-21 

recei ve-by-ref erence queue, 
3-21 
/ADV, 2-4, 2-5 
/ALL, 2-4, 2-5 
All devices switch 

See /ADV 
Analysis listings, 3-1 to 3-57 

interpreting, 4-1 
Analysis routines switch 

See /ALL 
Analysis switches, 2-3 to 2-7 
ANAL YZ E/CRASH_DUM P command, 1-8 

error messages, A-l 

examples, 2-21 

format, 2-11 

input to, 2-12 

qualifiers, 2-12 to 2-21 

specification, 2-12 
Assign table dump, 3-1, 3-17 

logical device names, 3-17 

physical device names, 3-17 
/ATL, 2-4, 2-5 

Binary output file size switch 

See /MEMS I Z 
/BL, 2-8 

Block number switch 

See /BL 
Bugcheck facility, 1-5 

error code definitions, D-l 

CDA 

analysis listing, 1-1, 1-6, 1-8, 
3-1 to 3-57 
See also Analysis listings 
function, 1-1 
generating, 1-1 
input to, 1-1, 1-3 
messages, A-l 



CDA (Cont.) 

running, 1-7 

as installed task, 1-7 
as uninstalled task, 1-8 

switches, 2-3 to 2-11 

system requirements, 1-1 
CDA command line, 2-1 to 2-11 

binary file, 2-2 

crash input file, 2-3 

default, 2-10 

format, 2-1 

in indirect command file, 1-8 

list file, 2-1 

symbol file, 2-2 
/CLI, 2-4, 2-6 
CLI parser block dump, 3-31 
CLKDF$, B-4, C-12 
Clock queue dump, 3-50 
Clock queue switch 

See /CLQ 
/CLQ, 2-4, 2-6 

Command line interpreter switch 

See /CLI, /CPB 
Common Block Directory dump, 3-36 
/CPB, 2-4, 2-6 
Crash 
cause 

determining, 4-1 
HALT instruction, 1-2 
infinite loop, 1-2 
processor trap, 1-2 
restart procedure, 1-3 
dump 

obtaining, 1-2 
Crash Dump Analyzer 
See CDA 

Crash dump binary file, 1-3, 1-6, 
2-2 

Crash dump device, 1-1, 1-3 
and drivers, 1-4 
changing, 1-4 
displaying, 1-5 
restrictions, 1-2 
specifying, 1-4, 1-5, 2-2 
valid for Micro/RSX system, 1-2 
valid for pregenerated 

RSX-11M-PLUS system, 1-2 
valid for RSX-llM/M-PLUS system, 

1-2 

Crash dump driver 

and devices, 1-4 

loadable, 1-1, 1-3 to 1-7 

loading, 1-4 

unloading, 1-5 
Crash dump listing 

See also Analysis listings 

interpreting, 4-1 to 4-3 
mapping data, 4-1 
stack depth, 4-2 
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Crash dump routine 

See Executive crash dump 
routine 

Crash notification device, 1-1, 

1-2, 1-3 
$CRAVL, 3-15, 3-45 
CTBDF$, C-14 
/CTL, 2-5, 2-6 
Current task priority 
pointer to, 3-20 

/DCB, 2-5, 2-6 
DCBDF$, B-6, C-15 
/DENS, 2-8 
/DEV, 2-5, 2-6 
Device 

crash dump, 1-1 

crash notification, 1-1 

See also Crash notification 
device 

fixed media, 1-3, 1-5 

invalid crash dump, 1-3, 1-5 

switches, 2-6 

system, 1-5 

unit number, 1-4 

valid crash dump, 1-2, 1-5 
Device controller dump, 3-51 

common interrupt address, 3-51 

Controller Request Block, 3-52 

controller status, 3-52 

Controller Table, 3-51 
Device controller switch 

See /CTL 
Device information dump, 3-38 

control processing flags, 3-39 

device characteristics word, 
3-39 

Device Control Block, 3-42 
I/O request packet, 3-42 
Status Control Block, 3-42 
terminal status word, 3-38 
UCB extension, 3-42 

Device names 
logical, 3-17 
physical, 3-17 

/DMP, 2-5, 2-6 

/DUMP, 2-5, 2-6 

EPKDF$, B-13, C-17 

Error code definitions, D-l 

Error log buffer 

address of, 3-19 
Error log packet dump, 1-9, 3-1, 
3-19 

Error messages, A-l 
EVNDF$, B-14, C-25 

Executive crash dump routine, 1-1, 

1- 2, 1-3 
building, 1-1 

Executive Debugging Tool 
See XDT 

Executive symbol table, 1-1, 2-2, 
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Executive symbol table (Cont.) 

switch 

See /STB 
/EXIT, 2-8, 2-9 
Exit switch 

See /EXIT 

F11DF$, C-28 
Fl 1TBL$ , B-17 

Function switches, 2-7 to 2-10 

Group-global event flag dump, 1- 
3-1, 3-18 

/HDR, 2-5, 2-6 
HDRDF, C-33 
HDRDF$, B-21 
HWDDF$, B-23, C-35 

ITBDF$, B-26 

/KDS, 2-5, 2-6 
Kernel data space 

dump, 3-53 

switch 
See /KDS 
Kernel instruction space 

dump, 3-53 

switch 
See /KIS 
Kernel Mapping Register switch 

See /KMR 
Kernel stack dump, 3-1, 3-5 
/KIS, 2-5, 2-6 
/KMR, 2-8, 2-9 
KRBDF$, C-41 

LCBDF$, B-27, C-43 
/LIMIT, 2-8, 2-9 
/LINES, 2-8, 2-9 
Lines per page switch 

See /LINES 
Loadable crash dump driver 

See Crash dump driver 
Logical device assignments, 3-17 
Logical device names, 3-17 
Low core memory 

dump, 1-9, 3-1, 3-20 

labels, 3-20 

MCR Unit Control Block, 3-26 
/MEMSIZ, 2-8, 2-9 
Micro/RSX 

Advanced Programmer's Kit, 1-1 
1-3 

MTADF$, B-28, C-44 

No spool switch 
See /-SP 

Offset mode, 3-1 
OLRDF$, C-47 

Output listing limit switch 
See /LIMIT 
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/PAR, 2-5, 2-7 
Partition 

base address, 3-21 

name, 3-21 

PCB address, 3-21 

status flags, 3-33 
Partition Control Block, 3-33 

address, 3-31 

pointer to, 3-33 

switch 

See /PCB, /PAR 
Partition information dump 

attachment descriptor, 3-34 

individual, 3-33 

system, 3-31 

wait queue, 3-34 
/PCB, 2-5, 2-7 
PCBDF$, B-31, C-55 
Physical device names, 3-17 
Physical memory switch 

See /DUMP 
$PKAVL, 3-45 
PKTDF$, B-33, C-60 
/POOL, 2-5, 2-7 
Pool 

bit map, 3-15 

dump, 3-45 

free, 3-15 

largest fragment, 3-15 
number of unallocated fragments, 
3-15 

secondary pool dump, 3-45 
size, 3-15 

smallest possible block, 3-15 

total free bytes, 3-15 
Pool statistics dump, 3-1, 3-15 
Processor Status Word, 3-2 
Program Counter, 3-2 

Qual i f iers 

command, 2-12 to 2-15 
crash-input, 2-15 to 2-21 

Register 

cache control, 3-3 

error, 3-2 

general, 3-2 

memory management, 3-2 

memory system error, 3-2 

page 

address, 3-2 
description, 3-2 

UNIBUS mapping, 3-2 

volatile, 3-1, 3-3 

See also Volatile registers 
Relative: addresses, 3-1 
RSX11M.STB 

See Executive symbol table 



Saved stack pointer 
/SCB, 2-5, 2-6 
SCBDF$, B-39, C-66 
Secondary pool 
dump, 3-45 
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Secondary pool (Cont.) 
switch 

See /SECPOOL 
/SECPOOL, 2-7 
SHDDF$, C-69 
/-SP, 2-8, 2-10 
Stack pointer 

kernel, 3-2, 3-5 
user, 3-2 
/STB, 2-2, 2-8, 2-10 
/STD, 2-5, 2-7 
$STKDP, 4-2 
Switches 

analysis, 2-3 to 2-7 
function, 2-7 to 2-10 
/-SYS, 2-5, 2-7 
System 

device, 1-5 

switches, 2-6 
generation 

and CDA, 1-1 
information, 3-1 
switch 

See /-SYS 
information dump, 1-8 
pool 

dump, 3-45 
swi tch 

See /POOL 
requirements, 1-1 
System common, 3-6 
active task, 3-6 
alphabetized dump, 3-1, 3-9 
boot device, 3-6 
dump 

See System common dump 
labels, 3-9 to 3-14 
network UIC, 3-6 
partition address, 3-6 
stack depth, 3-6 
system size, 3-6 
TCB address, 3-6 
UIC, 3-6 
System common dump, 3-1, 3-9 to 
3-14 

stack depth indicator, 4-2 
System Task Directory 
dump, 3-44 
switch 

See /STD 

/TAL, 2-5, 2-7 
Tape density switch 

See /DENS 
/TAS, 2-5, 2-7 
/TASK, 2-5, 2-7 
Task Control Block switch 

See /ACT, /ATL 
Task data space 

dump, 3-53 

swi tch 

See /TDS 
Task dump, 3-48 

window blocks, 3-48 



Index-3 



INDEX 



Task header 

pointer to, 3-20 

switch 

See /HDR 
Task header dump, 3-28 

Directive Status Word, 3-28 

File Control Block, 3-29 

Logical Unit Table, 3-28 

Page Description Register, 3-29 

swapping priority, 3-28 

window blocks, 3-29 
Task instruction space 

dump, 3-53 

swi tch 
See /TIS 

Task virtual address space switch, 
2-7 



/TCB, 2-5, 2-7 
TCB 

address of, 3-21, 3-24 
pointer to current, 3-20 

TCBDF$, B-41, C-71 

/TDS, 2-5, 2-7 

/TIS, 2-5, 2-7 

/TSK, 2-5, 2-7 

/UCB, 2-5, 2-6 
UCBDF$, B-45, C-75 

Volatile registers, 3-1 
dump, 3-2 to 3-4 



XDT, 1-2, 1-3, 1-6, 1-7 
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READER'S COMMENTS 
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